Skip To Content

Frequently asked questions

What is XLSForm?

XLSForm is a specification that describes how to define a form using a spreadsheet. It is a widely adopted standard and is described at length at

XLSForm allows you to specify what questions will be present in your form, how they are presented to the user, and how to validate the responses.

Numerous data collection tools use XForms as their input. XLSForm spreadsheets that you create are translated into an XML file following the XForms standard, which is then used in data collection tools.

Using the Survey123 website, you can bring your own XLSForms into ArcGIS.

Can I import existing XLSForms?


Survey123 for ArcGIS allows you to take existing XLSForms and import them into ArcGIS. You'll use Survey123 Connect for ArcGIS to do this.

If you create surveys that you want to share with others, you can send them the .xls (or .xlsx) file via email to import into Survey123 Connect for publishing.

What is the Survey123 website?

The Survey123 website is the heart of Survey123 for ArcGIS. Using the Survey123 website, you can manage your surveys, control who can contribute to them, and view and understand the data submitted to your surveys. The Survey123 website is a web browser-based application and is available at for ArcGIS Online users.

When should I use the Survey123 website to author my surveys versus Survey123 Connect for ArcGIS?

The advantage of the Survey123 website authoring tools is their ease of use: You can start creating surveys with no training. The type of questions and smart survey features available through the Survey123 website authoring tools are limited but are sufficient for basic surveys. If you need more advanced question types or more complex rules, you'll need Survey123 Connect for ArcGIS. In either case, your surveys will be displayed in the Survey123 website survey gallery, and you can share them and analyze your collected results in the Survey123 website as well.

Can I show specific questions based on the answers from other questions?

Yes. Using the Relevant column, you can hide some questions by default, and show them based on the answer from another question. For more information, see Relevant expressions.

Do I need to include a geopoint question in my survey?


If you do not include any geopoint questions, a location (SHAPE) column is automatically added to the main feature service layer. This is populated with the location information available from the device at the time the survey data was captured.

Can I control the initial extent, scale, and basemap in the map display for my geopoint question?


Using the Settings tab in the Survey123 Connect tool, you can configure the map settings for geopoint questions.

Can I use non-ASCII characters in my survey?


In Survey123 for ArcGIS, you can create surveys that display questions in any language or multiple languages. Non-ASCII characters are not allowed in the name column of your choices or survey worksheets. There is also a known issue that prevents the use of ASCII characters in the label column when using external selects.

Do surveys support right-to-left languages?


Surveys support right-to-left displays.

How many questions can a survey contain?

When publishing to ArcGIS Online, a survey can contain a maximum of 1,024 columns (including system fields), while a survey published to a portal can contain a maximum of 500. In both cases, this maximum limit can be circumvented by placing part of your survey into a repeat with a repeat count of 1 and storing that part of the survey in a related table.

Is there a limit on the number of choices shown in a pick list?

You can add pick lists to your surveys using select one types of questions. The only limit is what's practical for your survey users. Any list with more than 15 values will be difficult to use on a small display, such as a smartphone.

Can I use custom field types to restrict user input?

Surveys authored in Survey123 Connect can include custom field types such as esriFieldLength and esriInputMask that can be used to restrict user input. The Survey123 web app does not support custom field types; as a result, any associated behaviors will not be implemented.

What bar code formats does Survey123 support?

Survey123 supports the following bar code formats:

  • QR
  • Code 39
  • Code 93
  • Code 128
  • EAN 8
  • EAN 13
  • UPC A
  • UPC E
  • UPC EAN Extension
  • Aztec
  • Codabar
  • Data Matrix
  • ITF
  • MaxiCode
  • PDF 417
  • RSS 14
  • RSS Expanded

The default bar code question format is QR. To scan other codes, select them from the Menu Menu of the bar code scanning page.

Where are my surveys stored?

A survey is composed of two items in your ArcGIS Online account. One is Form item, which represents the questions and settings in your survey. The other is Feature Service item, which stores your survey data. Keep in mind that both of these items are required for your survey to behave normally.

Can I move my survey files to a different location on my machine?

Moving your survey files on your machine will cause Survey123 Connect to be unable to find them and will either return errors or show no evidence of the survey depending on how much information was moved.

Can I move the items for my survey to a different location in my ArcGIS organization?

Moving the items for your survey in your ArcGIS organization after the survey has been published will cause both Survey123 Connect and the Survey123 website to be unable to find them, and both will behave as if they never existed.

Can I transfer my survey files to a different machine?

Yes. After publishing a survey, you can use Survey123 Connect to download your files. Sign in with your ArcGIS organizational account, and click the thumbnail for the survey that appears to download.

Alternatively, if you want to transfer files before publishing, Survey123 Connect will display and open any survey in the My Survey Designs folder, provided all files are present in a folder and share the same file name. On all platforms, this folder can be found at \Username\ArcGIS\My Survey Designs.


Be sure to use the My Survey Designs folder, rather than the My Surveys folder that may be present. My Surveys is the folder the Survey123 field app uses for its downloaded surveys.

Can I modify an existing survey?

Before you publish a survey, you can modify the survey, such as changing the question label, adding questions, reordering questions, or deleting questions.

Once a survey is published, you can make limited modifications to it. Edits that do not require changing the schema of the feature service can be made without issue. For more information, see Publish your survey.

How can I integrate Survey123 with Workforce for ArcGIS?

Workforce for ArcGIS works well with Survey123 for ArcGIS, allowing dispatchers and mobile workers to communicate as they complete assignments. You can integrate with Survey123 to provide mobile workers a clean transition between updating their assignments in Workforce and capturing data in Survey123. To do so, create your survey, and configure Workforce to open that survey. For details on configuring Workforce, see Integrate other Esri apps. You can also learn more about Workforce through its resources.

Once you've configured your Workforce project, mobile workers can open Survey123 through Workforce, opening Survey123 with the associated survey and also creating a geopoint at the location of the assignment.

Why can't I access my Survey123 survey in Workforce?

Early adopter releases of Survey123 for ArcGIS used the ArcGIS Code Sample item type to store surveys in ArcGIS Online and ArcGIS Enterprise. These survey items are not supported in Workforce and will soon no longer be supported in Survey123. Be sure to upgrade your surveys or re-create the survey items with the latest version of Survey123.

Why can I no longer ignore SSL errors?

The option to ignore SSL errors has been disabled to address security concerns.