> 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/getting-started.md).

# Getting started

Field App brings Felt's modern mapping experience to your mobile device. Whether you're collecting data in the field, monitoring live operations, or reviewing dashboards between meetings, Field App connects you to your maps with real-time syncing across devices. Bringing an intuitive interface to field data collection workflows enables seamless collaboration between Felt's mobile and web platforms, which transforms how organizations bridge fieldwork and desktop workflows.

The app includes:

* **Full viewer experience:** access to all your maps and dashboards on mobile
* **Built-in GIS tooling:** measurements, spatial filters, table view, and search
* **Structured data collection:** use Felt layers and surveys to standardize how your team collects field data on the ground
* **Geotagged photos:** use location tracking to attach photos directly to features or location-based comments
* **Offline support** *(coming soon):* work without connectivity and sync when reconnected

<figure><img src="/files/idxnf5QQpzVoZT79GLDw" alt=""><figcaption></figcaption></figure>

## Download the app

#### Android

Download the Felt Field App from the [Google Play store](https://play.google.com/store/apps/details?id=com.felt.mobile).

#### iOS

Download the Felt Field App from the [App Store](https://apps.apple.com/us/app/felt-maps-field-surveys-gis/id6754033379).

## Log in

{% hint style="success" %}
You need a Felt account to sign into the Field App. [Create an account](https://felt.com/signup) on desktop first, or ask your Felt admin to invite you to the account.
{% endhint %}

You'll immediately be prompted to log in. Our mobile app log in supports both password and SSO authentication methods.

When using SSO authentication, first enter your email address and tap "Next." The SSO provider will be detected automatically.

<figure><img src="/files/Lis3jlNURxmxMd0wQmPm" alt="" width="188"><figcaption></figcaption></figure>

## Open a map

After signing in you'll be automatically directed to your Felt Workspace. You'll see the Felt home view showing you Recents, Felt maps you've recently viewed, by default. Tap on any of the maps to view the full map view.

<figure><img src="/files/3vCu3rBoORM7pDsrZd3F" alt=""><figcaption></figcaption></figure>

Clicking on the <img src="/files/x8snEeL7UNTTdE8NTa4n" alt="" data-size="line"> menu (top-left) lets you navigate around the Workspace to switch into projects, maps, and manage Workspace settings.

<figure><img src="/files/GVb6mTtwwjxTVCPLjkW7" alt="" width="188"><figcaption></figcaption></figure>

{% hint style="info" %}
Looking for a complete tour of the app? Check out [Tour the Field App](/field-app/tour-the-field-app.md).
{% endhint %}

#### Open map links via email

The Field App supports deep linking for map links, which means when the Field App is installed, opening a map link on mobile will automatically open the map in the Field App. When your email address is invited to a map in the [Share menu](https://help.felt.com/sharing-and-collaboration/sharing-a-map#share-menu), you will receive an email with a link to view the map. Tapping on the link in the email will automatically open the map in the Field App.

## Contribute

Your ability to **comment** or **collect data** depends on your permissions to the map being viewed. Anyone with a Felt account can open and comment on maps in the Field App. Members with **Contribute** permission can also draw annotations, edit features, and add new features. Members with **Edit** permission have all the same capabilities plus map management. For more detailed information on permissions, see our [FAQ](https://help.felt.com/field-app/getting-started?q=field+a#how-do-permissions-work-with-the-field-app).

### Comment

Leaving a comment on the map is helpful for adding ad-hoc field observations and collaborating with teammates in real-time to resolve issues and coordinate plans. Data gathered with comments includes free text and photos, and you can tag teammates to notify them via email immediately.

1. Tap the plus button <img src="/files/4BCexrU4qpRdNIVGnveg" alt="" data-size="line"> on the bottom-right and select **Comment** from the menu panel. (Viewers will see a comment button <img src="/files/AcoEaypEJjGGY0IUlKgq" alt="" data-size="line"> instead)

<figure><img src="/files/98QS7jZWOO3Nv4avFmcl" alt="" width="188"><figcaption></figcaption></figure>

2. Pan around the map to position your comment. You can use location tracking to snap the crosshairs to your current location. Tap on the location icon ![](/files/NvlZETRn3V2SGPWJAIb7) on the bottom right of your screen.
3. Type in your comment in the bottom panel.

   1. Viewers can tag teammates (<img src="/files/g9I03tMjFrzwxfynxyWc" alt="" data-size="line">) and tag features (**`+ ...`**). Members with Contribute or Edit permission can also add photos (<img src="/files/XNYUk50fc0GTCpkchcAS" alt="" data-size="original">).

   <figure><img src="/files/pDHRZl10bxFNwQDRBJ2z" alt="" width="375"><figcaption></figcaption></figure>
4. Tap the pink submit arrow button <img src="/files/ulQq5KRh9mqeVv8heCeE" alt="" data-size="line"> to add comment to map

#### Tagging features

Comments automatically detect if you are near existing features, and you can tag specific features to associate the comment with that feature. When your comment is near multiple features, tap on the **`+ Point at`** option from the comment panel to select which feature to tag in the comment.

<figure><img src="/files/Ji9uMGa2ifprdVLHMhXm" alt="" width="188"><figcaption></figcaption></figure>

When only one feature is nearby, the comment panel will mention the specific feature:

<figure><img src="/files/d8l62uBo7xVqDEiwvE6B" alt="" width="375"><figcaption></figcaption></figure>

You can also tag features directly from the feature popup panel. Click on the **`...`** menu in the popup panel to add a comment.

<figure><img src="/files/zbWbVtUFINRoHnXOfLWs" alt="" width="188"><figcaption></figcaption></figure>

#### Managing comments

In the Field App you can manage comments on each map.

Click on the **`...`** at the top-right of the map view to view the comment panel and all comments in list form. Double-tap on a comment from the panel to zoom directly to it.

{% columns %}
{% column %}
From the comment panel you can:

* Show/hide comments on the map
* View resolved comments
* Zoom to comment (double tap)
  {% endcolumn %}

{% column %}

<figure><img src="/files/fDm2gRbCTDAPqmoggLI5" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
From this comment view panel, tapping on **`...`** next to each comment allows you to:

* Resolve comments
* Copy a map link to specific comments
* Copy comment ID (for API)
* Delete comments
  {% endcolumn %}

{% column %}

<figure><img src="/files/E89hFSZwj1pengDhgEL1" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
Manage individual comments by tapping on the **`...`** menu next to the specific comment from the map view:

* Resolve the comment
* Edit the comment
* Copy a link to specific comments
* Copy comment ID (for API)
* Delete comments
  {% endcolumn %}

{% column %}

<figure><img src="/files/oX2uiU0ewETZmpyuAeBS" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Looking for a complete tour of the app? Check out [Tour the Field App](/field-app/tour-the-field-app.md).
{% endhint %}

### Data collection

Use data collection workflows when you need to build and maintain a structured dataset, manage assets on the ground, collect records that will persist long-term, and to run reporting from field observations. Online edits on mobile are immediately reflected for other viewers looking at the map.

You must have editor permissions to create new features or edit data layers on the map.

<figure><img src="/files/C72AlGEFLm4SOvQT2JKJ" alt=""><figcaption></figcaption></figure>

1. Tap the plus button <img src="/files/4BCexrU4qpRdNIVGnveg" alt="" data-size="line"> on the bottom-right.
2. Tap on the layer you want to add features to from the panel (**`ADD DATA`** section)

   <figure><img src="/files/lddGJggFa2IvYfdUvcdX" alt="" width="188"><figcaption></figcaption></figure>
3. A crosshair will appear on the map where the point (or first point) will be placed. You can use [location tracking](#location-tracking) to snap the crosshairs to your current location. Tap on the location icon ![](/files/NvlZETRn3V2SGPWJAIb7) on the bottom right of your screen.

   <figure><img src="/files/N4HNjwOxcYRIv3hPsjYc" alt="" width="196"><figcaption></figcaption></figure>
4. Pan across the map and tap **`Add Point`** to place a vertex. For lines and polygons, the point will add a vertex to the shape and each tap will extend your shape from the last vertex
5. Continue panning to place additional points, tapping **`Add Point`** to place more vertices

{% columns %}
{% column width="50%" %}

<div align="center"><figure><img src="/files/TjiZQN583FP6o7B5Jde4" alt="" width="188"><figcaption></figcaption></figure></div>
{% endcolumn %}

{% column width="50%" %}

<div align="center"><figure><img src="/files/J2kCi2vxwTdnI66a7HAn" alt="" width="188"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

6. Tap **`Done`** (or double-tap **`Add Point`** ) to exit edit mode

{% hint style="info" %}
While drawing you can undo / redo your edits by tapping on the arrows (bottom-left)

<img src="/files/zpL5jFRfaPw0kEf6jVmf" alt="" data-size="original">
{% endhint %}

#### Supported data types

* Points
* Lines
* Polygons

#### **Edit existing features**

To edit existing features, tap on the feature and then tap on the pencil icon <img src="/files/SJtCf8Zc7YTMdwMFqcOz" alt="" data-size="line"> from the popup panel. You'll first be shown the attribute table to edit the feature's attributes, but tapping **`Edit geometry`** allows you to adjust the shape of the feature.

<figure><img src="/files/rd62bfennh9LQP33aawZ" alt="" width="188"><figcaption></figcaption></figure>

Tap any existing vertex to select and edit it, or move the entire shape by dragging it around the map. For lines and polygons, **pink-filled circles, called "hint vertices" will appear** between vertices as you zoom in around a shape. Tapping them will add new points to the layer between the existing vertices.

<figure><img src="/files/67DnrWrKk7pKQUT4n8ny" alt="" width="188"><figcaption></figcaption></figure>

{% hint style="info" %}
Hint vertices (pink-filled circles) are a quick and easy way to add complexity and detailed edges to the geometry of existing features.
{% endhint %}

For lines, tap on the feature and then tap **`Edit Geometry`**. Then you can select any endpoint vertex and tap on the `Extend` button at the top of the screen.

<figure><img src="/files/wMJa3WlTGhKTIaNVMsHS" alt="" width="375"><figcaption></figcaption></figure>

#### Deleting features

1. Tap on the feature from the map view
2. Tap on the edit icon <img src="/files/SJtCf8Zc7YTMdwMFqcOz" alt="" data-size="line"> in the popup panel
3. Tap on the **`...`** in the edit panel
4. Tap **`Delete feature...`**
5. Confirm deletion

<figure><img src="/files/eHAhAAldQuVn4Yts2ey9" alt="" width="188"><figcaption></figcaption></figure>

## Additional Settings

{% hint style="info" %}
Looking for a complete tour of the app? Check out [Tour the Field App](/field-app/tour-the-field-app.md) next.
{% endhint %}

### Location tracking

The Field App can connect to your device's GPS setting to contribute to the map based on your precise location, which updates in real time. The location tracking works when drawing all geometry types: points, lines, and polygons. So you can add points and trace paths based on your location.

You can access this setting by tapping the location icon ![](/files/NvlZETRn3V2SGPWJAIb7) on the bottom-right of the screen. The first time you enable this you will see your device ask for permission to use your location.

<figure><img src="/files/yIREfKd0O91mToWHSu4v" alt="" width="188"><figcaption></figcaption></figure>

When location tracking is enabled the icon will be a solid blue <img src="/files/k3xlqLHdMJQahB9MefWU" alt="" data-size="original"> and your location will appear on the screen as a blue dot.

<figure><img src="/files/z3ethJDc8zGDQFbUgI9C" alt="" width="188"><figcaption></figcaption></figure>

While collecting point, line, or polygon data, you can use location tracking to snap the vertex to your current location. While drawing on the map, tap the location icon to snap the crosshairs to your location. You will see location accuracy indicator in blue at the top of your screen. Tapping on the accuracy indicator will show you more details on GPS accuracy.

<div><figure><img src="/files/N4HNjwOxcYRIv3hPsjYc" alt=""><figcaption></figcaption></figure> <figure><img src="/files/JZLTF1uWTxgXl3jeQFVX" alt=""><figcaption></figcaption></figure> <figure><img src="/files/nfsfnLNUsuemfGw4Hokz" alt=""><figcaption></figcaption></figure></div>

Note: location tracking is only available while creating features, not while editing existing ones. This prevents accidentally destroying geometry if you're far from the feature you're editing

## Frequently asked questions

<details>

<summary>What plans have access to the Field App?</summary>

The Field App is available on all paid plans. Professional and Enterprise both include the full set of field features:

* Mobile data collection
* Adding geotagged photos
* Data editing
* Survey forms with branching logic
* Offline support (in beta)

Viewers in your workspace can use the Field App to view maps shared with them. To collect or edit data in the field, a member needs a full seat.

</details>

<details>

<summary>What's the difference between viewing a map on my mobile browser versus the Field App?</summary>

Both experiences are optimized for mobile, but the Field App offers the best mobile experience of Felt maps. We generally recommend downloading the app for Felt maps on mobile.

The Field App also offers features that aren't available in the mobile browser:

* Photo capture for comments
* Surveys and data collection
* Offline support

</details>

<details>

<summary>How does sharing work on mobile?</summary>

Anyone viewing maps in the Field App needs to have a Felt account, so they should be invited to the map or to your Felt workspace.

Public sharing (access for anonymous viewers via map link) allows viewers to open the map on desktop or mobile browsers.

</details>

<details>

<summary>Can I create new maps in the Field App?</summary>

No, the mobile app is optimized for field work and data collection. To create and design maps, you'll need to use Felt's web app on a tablet or desktop.

</details>

<details>

<summary>What are the key differences between the desktop and mobile experience for Felt admin and editors?</summary>

There are a few key differences to outline:

* The desktop interface has pink **`Edit`** /**`Done`** buttons at the top of the screen to toggle into edit mode, while the mobile experience does not have this toggle.
* A toolbar is visible at the top of the screen while editing on desktop, but the mobile toolbar sits within the pink plus button at the bottom right of the screen for editors.
* The legend sits on the left-hand side of the screen, while the legend on mobile sits in the bottom panel of the view.
* The desktop editing experience requires internet connectivity, while mobile supports offline viewing and editing mode.

Legend interactions, and workspace navigation experiences are very similar across all platforms.

</details>

<details>

<summary>What types of data can I collect with the Field App?</summary>

On Professional and Enterprise plans you can collect point, line, or polygon data with the Field App. For any of these features you can collect text fields, dates, date time, numbers, true/false, and images.

Anyone with access to a map can add comments and annotations from the Field App. Comments can tag existing features (points, lines, or polygons). Members with Contribute or Edit permission can attach photos to comments.

</details>

<details>

<summary>How can I use the legend on mobile?</summary>

The legend is fully interactive on mobile, and so are layer components. For more information see [Tour the Field App](/field-app/tour-the-field-app.md#bottom-panel)

</details>

<details>

<summary>Can I work offline in the Field App?</summary>

Offline support is coming soon! When available, you'll be able to download maps before heading into the field, continue working without connectivity, and sync automatically when you reconnect.

</details>

<details>

<summary>When should I use comments vs data collection?</summary>

Use **data collection** when you need the information to persist as a feature, collect data in a consistent format across your team, manage assets, and creating datasets that need to be analyzed in spatial reports. Data collection creates layers in Felt.

Use **comments** when you need to communicate quickly, flag something temporarily, or share observations that don't need to be part of your permanent dataset

</details>

<details>

<summary>How do permissions work with the Field app?</summary>

Viewers can:

* Navigate the Workspace projects, folders, and maps on mobile
* View maps
* Search on maps
* Change basemap
* Interact with the legend
* Utilize table view
* Add, edit, and delete comments
* Add comments to features
* Use Find, Measure, and Spatial filter extensions. Custom AI extensions are Enterprise only.

Members with **Contribute** permission can do everything viewers can do plus:

* Draw annotations
* Add photos to comments
* Draw new features
* Edit existing features
* Access maps offline (in beta)

Members with **Edit** permission can do everything Contributors can do plus:

* Manage map sharing

</details>

<details>

<summary>How do I draw a circle with the Field App?</summary>

Felt supports drawing circles for annotations, measure, and spatial filter extensions. Tap the map to set a center point, then drag your finger across the screen to set the radius and adjust as needed.

</details>

<details>

<summary>Are custom extensions available on mobile?</summary>

Yes, custom extensions are supported on the mobile version of Felt maps.

</details>

<details>

<summary>Does Felt support deep linking?</summary>

Yes, when the Field App is installed, tapping on a map link from on mobile (from an email, slack message, etc) will automatically open the map in Field App.

</details>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.felt.com/field-app/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.