Skip to main content

Publish a survey

After previewing a survey in Survey123 Studio, but before you deploy it, you need to publish it.

Survey options

In the Options panel for the survey in Survey123 Studio, you can change the survey behavior as follows:

  • Enable Sent folder—Provides access to the Sent folder, which allows access to surveys previously sent from this device. Enabling this option reveals additional options to configure whether these responses can be edited after submission. For more information, see Sent folder.

  • Image size on the longest edge—Controls the maximum dimensions for images submitted to the survey. For more information, see Images.

Publish a new survey

To publish a newly created survey, complete the following steps:

  1. Sign in to your ArcGIS organizational account.

  2. Select the survey from the Survey123 Studio gallery.

  3. Click the Publish button.

    When you publish, you are warned that once a survey is published, it may not be possible to change it. This is because feature layers are generated during publication, and editing of existing feature layers can be complex or, in some cases, impossible. When you publish a survey, the following occurs:

    • The form is saved as an item in ArcGIS Online or ArcGIS Enterprise.

    • A feature layer is created to store form responses.

    • If the form contains repeats, related tables or layers are created in the feature layer for each repeat.

    • A _form feature layer view is created for submissions, and a _results feature layer view is created for data access.

  4. Click the Options button to configure how the survey is published.

    For more information, see Publish options.

  5. Click the Publish survey button.

    The survey's items are created, and the results of the publishing processes are displayed.

The survey is available for use. Depending on the publish options selected, the survey can be accessed as a web form or downloaded to a mobile device.

Immediately after being published, the survey is only available to you. To allow others to download and use the survey, see Share surveys.

Publish options

The Options button on the Publish Survey dialog box displays the following configuration options when publishing a new survey that does not use an existing feature layer:

  • Create coded value domains from choices is on by default, and the choice list for a question will be used to create coded value domains in the feature layer. For more information, see Multiple choice questions.

  • Use global ID parent keys in repeat relationships is on by default when publishing to ArcGIS Online and off by default when publishing to ArcGIS Enterprise. If your work involves copying survey data between databases, it is recommended that you do not use global ID parent keys in repeat relationships.

  • Create web form is on by default. When this is off, publishing a survey does not create a matching web form to allow users to complete the survey in the Survey123 web app.

  • Create web map is on by default, and a web map is created containing the survey's feature layer, with default symbology and using your organization's default basemap.

    Note:

    For ArcGIS Enterprise, some additional configuration may be required for web maps to function offline. For more information, see Take web maps offline.

  • Enable sync is off by default. When this is on, the sync capability is enabled on the survey's feature layer when the survey is initially published. This is a requirement if a survey uses offline map areas that have been configured for a web map. Alternatively, you can enable sync after publishing using the Settings tab on the item details page for the feature layer in your ArcGIS organization.

Note:

When updating a published survey, only the Create web form option appears. If you add a repeat when republishing the survey, the Use global ID parent keys in repeat relationships option appears. When publishing a survey from an existing feature layer, only the Create web form and Create web map options appear. All other options on the Publish Options dialog box are only applicable when new feature layers are being created during publishing.

Sent folder

If the Sent folder is enabled, submitted survey responses are saved on the user's device and listed in the Sent folder for the survey in Survey123 Mobile.

You can allow users to edit and resubmit their own sent surveys. Editing of sent surveys is disabled by default. To enable editing, choose Allow sent surveys to be edited in the Options panel in Survey123 Studio.

The Sent folder is enabled by default but can be disabled in the Options panel in Survey123 Studio. When the Sent folder is disabled for a survey, responses are not saved on the device, and the option to open the Sent folder does not appear.

Linked content

In the Linked Content panel for a survey in Survey123 Studio, you can link CSV files for use as external choice lists in the survey. The survey must be published before content can be linked to it.