> For the complete documentation index, see [llms.txt](https://help.felt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.felt.com/field-app/tour-the-field-app.md).

# Tour the Field App

A guided tour of the Felt Field App, the controls you'll reach for most when you're out in the field.

The Field App puts your Felt maps in your pocket, with a layout built for touch. This tour shows the controls you'll use most in the field: your location, the menu for adding data, the bottom panel, and the map's options. To install the app, log in, and open a map, see [Set up the Field App](https://help.felt.com/field-app/set-up-the-field-app.md).

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2Fgit-blob-5d4d701a83f86ff6dde655ce2630497a77517656%2Ffield-app-map-view.webp?alt=media" alt="Annotated Field App map view labeling the Felt menu and Map tools at the top, the Location button and Add menu, and the bottom panel with the legend."><figcaption></figcaption></figure>

## Show your location on the map

Location tracking in the Field App shows where you are with a blue dot.

1. Tap the location button <img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2F8tFJWCfcSbOBUQvdf65j%2Flocation-off.svg?alt=media&amp;token=03193d07-202d-4ed1-a9d0-0cfe31692963" alt="" data-size="line"> at the bottom right of the map.
2. The first time, allow Felt to use your location. The map centers on you and follows you as you move. The arrow in the button turns solid blue, and your location appears as a blue dot.

If you pan away, tap the location button to center the map on you and follow your location again. If your location doesn't appear, allow location access for Felt in your phone's settings.

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2Fgit-blob-ac0e6ce21e9206d02d765f010f6ab59dc44f5613%2Ffield-app-location-dot.png?alt=media" alt="Field App map with the blue location dot and its accuracy circle, and the location button with a solid blue arrow at the bottom right." width="300"><figcaption></figcaption></figure>

### Use your location to capture data

Location tracking also works while you add points, lines, and polygons, so you can place features where you're standing and trace paths as you walk. While you add a feature, tap the location button to move the crosshair to your location, then tap **Add point**. The accuracy of your location appears in blue at the top of the screen.

Tap the accuracy to open **GPS Details**, which shows your location, accuracy, altitude, speed, and heading. To use a high-accuracy receiver, see [GNSS receivers](https://help.felt.com/field-app/gnss-receivers.md).

The location button is hidden while you edit an existing feature, except when you extend a line, so a stray tap can't move the feature to wherever you happen to be.

The Field App doesn't record a GPS track in the background. To map a route, add a feature to a line layer with location tracking on, and tap **Add point** at each vertex. See [Capture field data](https://help.felt.com/field-app/collect-field-data.md).

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2Fgit-blob-7018065057bc024b36da33106a8850f9013557d3%2Ffield-app-location-vertex.webp?alt=media" alt="Adding a polygon vertex with the crosshair on the current location and the accuracy shown at the top of the screen." width="300"><figcaption></figcaption></figure>

## Add features, annotations, comments, and measurements

Tap the **+** button <img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FT2JpsQBf2M0DdcHukjCm%2Ffab%20(1).png?alt=media&amp;token=a0d38547-8091-45be-91eb-6b5401131b26" alt="" data-size="line"> at the bottom right of the map to see what you can add. The menu shows only the options your access allows.

| Option         | What it does                                                                                                         |
| -------------- | -------------------------------------------------------------------------------------------------------------------- |
| Comment        | Place a comment. See [Comments in the Field App](https://help.felt.com/share/comments.md#comments-in-the-field-app). |
| Measure        | Measure a distance or an area. See [Measure](https://help.felt.com/tools/measure.md).                                |
| Add feature    | Add a feature to a layer. See [Capture field data](https://help.felt.com/field-app/collect-field-data.md).           |
| Add annotation | Draw a pin, line, polygon, or circle. See [Draw on the map](https://help.felt.com/annotations/draw-on-the-map.md).   |

Adding features and annotations needs a seat and Contribute or Edit access to the map. If you can only comment, a comment button replaces the **+** button.

## Find the legend, feature details, and the table

The panel at the bottom of the map opens on the legend. Drag the panel to resize it, and tap the map to collapse it.

* Legend: tap a layer to show or hide it, zoom to it, or use its components. See [Legend](https://help.felt.com/layers/legend.md).
* Feature details: tap a feature on the map to open its popup in the panel. To edit it, tap the edit button <img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FENLJeZudD2yYv7HYQo8R%2Fedit.svg?alt=media&amp;token=b43e7ed6-f7f3-4472-84f6-9e16964c72d9" alt="" data-size="line">.
* Table: tap **···** at the top right, then **Table**. Double-tap a row to zoom to its feature. See [Table](https://help.felt.com/tools/table.md).

To switch between the legend, the table, and a popup, tap the title at the top of the panel.

## Map options in the Field App

The **···** menu at the top right of the map view holds the map's options. Search is next to it.

| Option        | What it does                                                                                   |
| ------------- | ---------------------------------------------------------------------------------------------- |
| Share         | Manage who can access the map. See [Share a map](https://help.felt.com/share/share-a-map.md).  |
| Basemap       | Switch the basemap. Without Edit access, the change is only for you.                           |
| Offline areas | Download part of the map. See [Work offline](https://help.felt.com/field-app/work-offline.md). |
| Table         | Open the table for the map's layers.                                                           |
| Comments      | Read, resolve, or delete comments.                                                             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.felt.com/field-app/tour-the-field-app.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
