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:

  • 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.
  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.