# 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
## 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.
## 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.
Clicking on the menu (top-left) lets you navigate around the Workspace to switch into projects, maps, and manage Workspace settings.
{% hint style="info" %}
Looking for a complete tour of the app? Check out [tour-the-field-app](https://help.felt.com/field-app/tour-the-field-app "mention").
{% 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. Viewers can open and comment on maps with the Field App. Contributors can comment, draw annotations, edit features, and add new features. Editors can comment, draw annotations, edit features, and add new features. 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 on the bottom-right and select **Comment** from the menu panel. (Viewers will see a comment button instead)
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  on the bottom right of your screen.
3. Type in your comment in the bottom panel.
1. Viewers can tag teammates () and tag features (**`+ ...`**). Editors on enterprise plans can also add photos ().
4. Tap the pink submit arrow button 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.
When only one feature is nearby, the comment panel will mention the specific feature:
You can also tag features directly from the feature popup panel. Click on the **`...`** menu in the popup panel to add a comment.
#### 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 %}
{% 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 %}
{% 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 %}
{% endcolumn %}
{% endcolumns %}
{% hint style="info" %}
Looking for a complete tour of the app? Check out [tour-the-field-app](https://help.felt.com/field-app/tour-the-field-app "mention").
{% 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.
1. Tap the plus button on the bottom-right.
2. Tap on the layer you want to add features to from the panel (**`ADD DATA`** section)
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  on the bottom right of your screen.
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%" %}
{% endcolumn %}
{% column width="50%" %}
{% 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)
{% 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 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.
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.
{% 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.
#### Deleting features
1. Tap on the feature from the map view
2. Tap on the edit icon in the popup panel
3. Tap on the **`...`** in the edit panel
4. Tap **`Delete feature...`**
5. Confirm deletion
## Additional Settings
{% hint style="info" %}
Looking for a complete tour of the app? Check out [tour-the-field-app](https://help.felt.com/field-app/tour-the-field-app "mention") 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  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.
When location tracking is enabled the icon will be a solid blue and your location will appear on the screen as a blue dot.
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.
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
What plans have access to the Field App?
The app is accessible to all plans. Everyone with a Felt account can download and use the Field App to view maps.
Enterprise customers have access to premium features in the app, including:
* Mobile data collection
* Adding photos
* Data editing
* Offline maps
* Contributor license
What's the difference between viewing a map on my mobile browser versus the Field App?
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.
For Enterprise customers, Felt offers enhanced functionality for desktop and mobile:
* Photo capture for comments
* Surveys and data collection
* Offline support (Field App only)
How does sharing work on mobile?
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.
Can I create new maps in the Field App?
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.
What are the key differences between the desktop and mobile experience for Felt admin and editors?
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.
What types of data can I collect with the Field App?
On 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.
On any plan you can add comments and annotations to the map from the Field App. Locations can tag existing features (points, lines or polygons). On Enterprise plans you can collect photos with comments.
How can I use the legend on mobile?
The legend is fully interactive on mobile, and so are layer components. For more information see [#bottom-panel](https://help.felt.com/tour-the-field-app#bottom-panel "mention")
Can I work offline in the Field App?
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.
When should I use comments vs data collection?
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
How do permissions work with the Field app?
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 measure and spatial filter extensions (enterprise only)
Contributors (available on Enterprise plans) can do everything Viewers can do plus:
* Draw annotations
* Add photos to comments (enterprise only)
* Draw new features (enterprise only)
* Edit existing features (enterprise only)
* *Coming soon:* access maps offline (enterprise only)
Editors can do everything Contributors can do plus:
* Manage map sharing
How do I draw a circle with the Field App?
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.
Are custom extensions available on mobile?
Yes, custom extensions are supported on the mobile version of Felt maps.
Does Felt support deep linking?
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.
---
# Agent Instructions: 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=
```
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.
.png?alt=media&token=23036310-c729-44f0-a866-026daef2ee47)
menu (top-left) lets you navigate around the Workspace to switch into projects, maps, and manage Workspace settings.
.png?alt=media&token=f76e4803-47c3-4e10-8db2-d05263001f85)
.png?alt=media&token=a0d38547-8091-45be-91eb-6b5401131b26)
on the bottom-right and select **Comment** from the menu panel. (Viewers will see a comment button 
instead)
) and tag features (**`+ ...`**). Editors on enterprise plans can also add photos (
).
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.
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.
.png?alt=media&token=e8ff8a62-e2a4-4f45-ae6f-d03ee5ea87bf)
.png?alt=media&token=b6e021f6-09b0-4221-b2e8-4445e2699f96)
and your location will appear on the screen as a blue dot.
.png?alt=media&token=3c3aab82-9a16-4a35-aaae-62df4d8587f1)
