> For the complete documentation index, see [llms.txt](https://guides.fieldedgeapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.fieldedgeapp.com/guide-to-canvassing-and-calls/reporting/user-location-tracking.md).

# User location tracking

{% hint style="info" %}
Not available on all plans
{% endhint %}

FieldEdge tracks the GPS location where your canvassers log activity and compares it to the household's known location. This helps Campaign Managers spot anomalous behavior — especially useful when managing paid canvassers.

Location tracking is built into the **Stream** on the [Performance](/product-tour-or-hq/performance.md) page. There is no separate map view — location data appears as distance warnings on each activity card in the Stream.

## How It Works

When a canvasser completes a household during a walk, FieldEdge records two GPS coordinates:

* **Household location** — the address coordinates from NationBuilder
* **Activity location** — where the canvasser's device was when they logged the activity

The distance between these two points is calculated automatically and displayed on the activity card in the Stream.

## Distance Warnings

Activity cards in the Stream display a distance badge when location data is available. The badge is color-coded by severity:

| Distance  | Severity   | What It Means                                                |
| --------- | ---------- | ------------------------------------------------------------ |
| 0–30 m    | No warning | Canvasser was at or very near the household                  |
| 30–100 m  | Low        | Canvasser was nearby — typically normal                      |
| 100–500 m | Medium     | Canvasser was some distance away — worth reviewing           |
| 500+ m    | High       | Canvasser was far from the household — may indicate an issue |

{% hint style="info" %}
Use the **Warnings only** toggle in the Stream filters to show only activities with distance warnings. This is the fastest way to review location anomalies.
{% endhint %}

## Viewing Location Details

Tap an activity card in the Stream to open the detail sheet, which shows:

* **Household address** — clickable link to Google Maps
* **Household coordinates** — GPS lat/lng with a Google Maps link
* **Activity coordinates** — where the canvasser actually was, with a Google Maps link
* **Distance** — the calculated distance between the two points, with a "Get directions" link

{% hint style="info" %}
If a canvasser's device did not capture GPS coordinates, the activity card will show a "Not captured" badge instead of a distance.
{% endhint %}

{% content-ref url="/pages/81skv3NJj2yndoj1ERkb" %}
[Performance](/product-tour-or-hq/performance.md)
{% endcontent-ref %}