> ## Documentation Index
> Fetch the complete documentation index at: https://docs-cbf.growthtak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPS tagging of visits

> Optionally capture and verify the supervisor's location when recording a day entry.

GrowTak can capture a supervisor's **GPS location** when they record a day entry, giving proof that the visit happened at the farm. This is **off by default** and is controlled per company.

## Turning it on <Icon icon="user-tie" /> admin only

In [Company Settings](/setup/company-settings) → **GPS**:

| Setting                        | Options                              | Meaning                                                           |
| ------------------------------ | ------------------------------------ | ----------------------------------------------------------------- |
| **GPS Capture Mode**           | `disabled` / `optional` / `required` | Whether the location field appears, and whether it's mandatory.   |
| **GPS Accuracy Threshold (m)** | default 500                          | Warn when the reading's accuracy is poorer than this many metres. |
| **Min. Geo Distance (KM)**     | default 2                            | How far from the farm still counts as "in place".                 |

## Capturing a location <Icon icon="person-walking" />

When capture is enabled, the day entry form shows a **location** control:

<Steps>
  <Step title="Tap the location button">
    GrowTak asks your browser/phone for the current position (you may need to allow location access).
  </Step>

  <Step title="Wait for the fix">
    Capture times out after about **15 seconds**. If it fails, you'll see an error with a **Retry** option.
  </Step>

  <Step title="Review">
    The captured point gets a **View map** link. If accuracy is poorer than the threshold, you'll see a warning — try again in a more open spot for a better fix.
  </Step>
</Steps>

## In place vs Away

GrowTak compares the captured point to the **farmer's saved location** and shows a **geo status** badge on the day entry:

| Badge        | Meaning                                                    |
| ------------ | ---------------------------------------------------------- |
| **In place** | Captured within the **Min. Geo Distance** of the farm.     |
| **Away**     | Captured further than that distance.                       |
| **— / N/A**  | No location captured, or the farmer has no saved location. |

<Tip>
  For accurate distance checks, make sure each [farmer](/farmers-batches/farmers) has a precise **geo location** set on their record.
</Tip>

## When "required" is actually enforced

Even with mode set to **required**, GrowTak only *forces* a location when it makes sense — for a **supervisor on a mobile device**, and only when the **farmer has a saved location** to compare against. In other cases (e.g. an admin on desktop, or a farmer with no saved location) the field gracefully falls back to **optional**, so legitimate entries are never blocked.