ArcGIS QuickCapture: Hazards project tutorial

06-26-2019 12:27 AM
Labels (1)
Esri Frequent Contributor
2 9 3,808

In this step by step tutorial you will learn how to create an ArcGIS QuickCapture project using the ArcGIS Hazards feature service template and the ArcGIS QuickCapture designer. This is meant to be an introductory tutorial for building ArcGIS QuickCapture projects.


  • Some basic familiarity with ArcGIS Online.
  • A mobile device.
  • An ArcGIS Online or Enterprise account with permissions to publish feature services (Creator user type, for example)
  • Optionally, additional ArcGIS accounts with permissions to create features and the Field Apps Bundle (Field Worker, Creator or GIS Professional user types).


For this exercise, we will pretend you need to create an ArcGIS QuickCapture project to help field workers document hazards of different types. You will create and share a simple project for users to locate, categorize and take a photo of the hazard from the ArcGIS Quickcapture mobile app.


This step by step tutorial will guide  you through the following:

  • Creating an ArcGIS feature service using a predefined feature layer template.
  • Exploring and extending your feature service for use within ArcGIS QuickCapture.
  • Configuring your ArcGIS QuickCapture project with QuickCapture designer
  • Downloading and testing your project in the ArcGIS QuickCapture mobile app
  • Sharing your ArcGIS QuickCapture project.
  • Viewing results.

Following the entire tutorial to completion will take approximately 30 minutes.

Creating an ArcGIS feature service using a predefined feature layer template.

In this step you will create a new hosted feature service using a feature layer template.

Login into ArcGIS Online or ArcGIS Enterprise using an account with permission to publish feature services

Navigate to Content and Click on Create-Feature Layer

Search for the template called Hazards and create a new feature layer out of it

Feature services are the foundation of ArcGIS QuickCapture projects. The ArcGIS QuickCapture mobile app needs a feature service to store the data captured by the end user. The feature service also defines the attributes and geometry types of the observations captured from the mobile app. Feature services include symbology and editing feature templates which define the types of features to be captured. The symbology and the feature templates are used to create an initial set of buttons in your ArcGIS QuickCapture project.

Exploring and extending your feature service for use within ArcGIS QuickCapture

In this section you will explore in detail the default feature templates created in your feature service. You will learn why these feature templates are important to ArcGIS QuickCapture.  You will also learn how to add additional fields into your feature service for use within ArcGIS QuickCapture.

In the feature layer item details page, switch to the Data tab.

This is the list of fields currently in the feature layer. These fields can be used to store important information about the documented hazards. Next, we will add a couple of new fields which will be populated automatically by the ArcGIS QuickCapture mobile app at the time when the data is captured.

Click on the menu button in the top-right corner of the table and select Add Field

Add a new field to store the horizontal accuracy of the observation captured as a field of type double

Add another field to store the exact time when the observation is made.

As we will see later, ArcGIS QuickCapture can automatically populate specific values when data is captured from the app:

  • The speed at which the field user is traveling when an observation is made.
  • The direction of travel.
  • The exact time when the observation is made
  • The latitude, longitude and elevation of the device when the observation is made
  • And many other variables

When you author feature services for use within ArcGIS QuickCapture, it is important that you think about the attributes you will want ArcGIS QuickCapture to populate for you. You will need to create the corresponding fields.

Next, we are going to double check some important settings in your feature service.

Switch to the Settings tab

Make sure the following settings are checked:

  • Enable editing must be checked, or otherwise field users will not be able to add data to your layer.
  • What kind of editing is allowed must at least allow adding new features. From the ArcGIS QuickCapture app it is not possible to edit (update) or remove features. The mobile app can only add new features.
  • It is also good practice to enable the following options: Keep track of who created and last updated features, and Enable sync.

Switch to the Overview tab

Make sure attachments are enabled in your layer if you want to associate photos with your field observations.

You are now good to go, but for completeness, I want to describe in more detail the role of feature templates.  ArcGIS feature templates define in a feature service a collection of pre-configured feature types that can be created from different applications in ArcGIS.  It is up to you to define what feature templates are included in a feature service.

Since we created a feature service from an ArcGIS feature layer template, your feature service already includes a set of feature templates. Lets explore them.

From the Overview tab, click on Open in Map Viewer. This will load your empty feature service into the Map Viewer.

Click on Legend to display the predefined categories in your layer.

Note that categories such as Wire Down, Flooding or Dangerous Animal already have been configured on your behalf as part of this feature layer template.  These feature types and their symbology will be used to define the initial buttons of your QuickCapture project.

Click on Edit, and then on Manage. This will open a dialog from which you can modify the feature templates.

Note that each feature template specifies what default attributes will be stored when a new feature is created. All these values and rules will be used to define the behavior of your buttons in ArcGIS QuickCapture.  We will learn later how to use ArcGIS QuickCapture designer to further refine the look and feel and behavior of buttons in your ArcGIS QuickCapture project.

Configuring your ArcGIS QuickCapture project with QuickCapture designer

If you have a good feature service design, most  of your job is done. Lets learn how you can kick-start your ArcGIS QuickCapture project now.

Navigate to and login with your ArcGIS credentials.

Click on New Project

Select the new feature layer you created and hit next

You can select one or more feature services to create your ArcGIS QuickCapture project. Before you can actually create it, you will need to define a title, tags and also a data-recovery e-mail.  The data-recovery e-mail will be used by the ArcGIS QuickCapture mobile app in the event that field users have trouble uploading data through your ArcGIS QuickCapture project. In that case, you will receive an e-mail with an attachment including the data that failed to upload.

Complete the title and other properties and click Create.

Through ArcGIS QuickCapture designer you can easily change the visual characteristics of your buttons as well as their data behavior.  By default, QuickCapture designer creates a group of buttons for each layer in your feature service, and one button for each feature template. The symbology of your feature template is matched to equivalent display properties for your buttons.

Hover your mouse over the label of the Hazard group and click to select it.

Change the number of columns to 2

The number of columns used to display your buttons is an important decision. Switch the preview across the different from factors to see the impact of your selection in the project. If your field users will use a tablet, you can add 4 or even 5 columns to your group. If using a smartphone, you will rarely be able to use more than 3 columns before the labels start getting cut-off.

Click on the Road Not Passable button to display its properties in the right-side panel.

Change some of the display properties, such as Shape, Size, Label, etc. to see the effect it has in your project.

Again, when playing around with the display properties of your buttons, you need to think about your end users and what devices they will be using. Try to maximize the available screen real estate so you can make data capture easier. You will note that you can also reorder to position of buttons within a group.

While your Road Not Passable button is selected, click on the Data section of the right-side panel.

Enable photo capture with this button.

Look for the Horizontal Accuracy and Captured time fields you added before and set variables accordingly.

Note that in ArcGIS QuickCapture you capture data by simply pushing a button.  The application automatically associates a location with the selected feature type and also populates attributes as defined in the Data properties of the button.  As you define values for your feature attributes through the Data properties section, you can choose to set a static value, or a value set through a variable.  You cannot prompt the user to add free text (comments) or other values for the observation. All needs to be done with a simple tap!

You can change the visual and data properties of other buttons in the project and when ready, save the changes.

Click Save to persist all changes you made to the project.

ArcGIS QuickCapture projects are stored in your account as a dedicated ArcGIS item type (the ArcGIS QuickCapture project item type). You will be able to find the ArcGIS QuickCapture project item you created in your content.  A QuickCapture project can be related to one or more feature layer items.

Downloading and testing your project in the ArcGIS QuickCapture mobile app

Now that you have an ArcGIS QuickCapture project, you can downloaded into the ArcGIS QuickCapture mobile app.

If not already, download the ArcGIS QuickCapture mobile app from the app store (Apple or Google Play).

Login with your ArcGIS credentials. Click on Projects and download your Hazards project.

Capture data by pushing the hazard buttons.

You can make additional changes with ArcGIS QuickCapture designer at any time. Simply remember to Save your changes and update the project in the mobile app to see the changes.

Sharing your ArcGIS QuickCapture project

Once you are happy with your project, you will want to share it with people within your ArcGIS organization.   So far, you have been able to download the project in your mobile app because you are the author of the project, but nobody else in your organization will have access to it.

You can easily share your project right from within ArcGIS QuickCapture designer.

If any of the layers in your project cannot be shared with the groups you select in the dialog, you will get prompted to update the sharing of the feature layers accordingly.

Viewing results

All data captured from ArcGIS QuickCapture will be stored in your Hazards feature service. The easiest way to visualize the data is to create a web map.

Within ArcGIS QuickCapture designer, click on the top-left button to return to the project gallery.

Hover your mouse over your project and select View Results to open your project data in a web map.

Ideally, you will want to set a refresh rate on your web map to see changes in real time and put together a nice web mapping application or dashboard with your web map, but that would be the topic of another post.

Congratulations, you have created your very first ArcGIS QuickCapture project!

Tags (2)
New Contributor III


I just started exploring the features of QuickCapture.

I am trying to have an input text field (no domain) for an asset ID for the field collected data.

Would like it to be something similar to the one shown in this video at 27:48 (Route, Cost Center). 

Data Collection At Speed with ArcGIS QuickCapture - YouTube 

Was trying to do this in QuickCapture Designer, but could not figure it out. I have the "asset id" text field in my feature layer, but it is not showing up in the project as something that can be configured at QuickCapture Designer. 

If this is something that can only be done by JSON, can you post a snippet of code.

Thank you very much.

Esri Regular Contributor

Hi Ramon

We don't yet support the configuration of user inputs using the designer's UI. You must use the JSON editor to do this. We have documented the functionality here:

Please let me know if you have any questions.



New Contributor III

Can I have multiple buttons created from the feature domain list?

Esri Frequent Contributor

Hi Huong Tran‌  If I understand your question correctly, you want to create one button for each value in your geodatabase domain. If this is the case, you will want to first set the symbology of your feature layer to use a unique value renderer using your field with the domain. Create one category per value in your domain. Then import the feature layer in designer.

New Contributor III

Ismael Chivite Thanks for the reply when i created the feature on desktop it worked as planned.

I have another question when testing the application today in the field, while using it for less than 10 minutes my phone overheated, and when i stop the collection the second feature is taking a long time to send more than 30 minutes. I wonder if the delay is because the phone overheated. I am using a Google pixel 3 android version 9.

Esri Regular Contributor

Hi Huong - please drop me an email on so we can troubleshoot this. Thanks

New Contributor


I have created a Polyline Layer to capture the Start time, End time and Comments for road grading operations. Initial testing captures the required data, however our Assets Department wants me to add in a new field to capture the Vehicle ID number. I have opened the Feature Layer using ArcGIS Online and under the data tab clicked on 'Add Field'. The new field appears in the 'Fields' list, but will not show in the Line Layer Table. The new field appears to be available in QuickCapture, however I cannot see the field in table view to determine if data is being captured to the field. Note: I am the owner of the Project and also a site Administrator, so do not believe it to be permissions related.

Occasional Contributor

Hi Matt,

Please try the following,

1. In the line layer's Table view, click the hamburger icon and click Show/Hide Columns

2. You should see the new field in the list.

3. Toggle on the checkbox for this new field, it should appear in the Table view now.

Hope it helps. Let me know if you have any questions.



New Contributor

Thank you Mandy,

That was so easy and obvious, I feel a bit foolish, but has solved my query. Much appreciated.

Kind regards,