Publish a survey

After previewing your survey in the Survey123 website, but before you deploy it, you need to publish it.

Publish a new survey

To publish a survey you created in the Survey123 website, click the Publish button in the lower right corner of the Design page.

When you publish a survey, a feature layer is created to represent your form, and your form is saved as an item in ArcGIS Online or ArcGIS Enterprise. Before you publish a survey, you can click Modify schema in the lower left corner of the publish confirmation dialog box to open a table view containing all of the fields in your survey. This table allows you to change the name and maximum length of a field in the underlying feature layer, which are otherwise set automatically. The new name of the field is not visible in Survey123 or other applications, which display the label provided when the survey was created.

The Modify schema table allows you to change the name and length of fields in your survey.

When you publish, you are warned that once a survey is published, it cannot be changed. 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, a feature layer is created to represent your form, and your form is saved as an item in ArcGIS Online or ArcGIS Enterprise.

Your survey is available to be sent to users for completion online and for download and use in the Survey123 field app.

Update surveys

Your survey is composed of two parts: the form item that the app downloads and the feature layer that contains the data submitted from the survey. It's possible to edit a survey and republish it without deleting the feature layer.

After making changes to your survey, you can typically republish it without deleting and re-creating the feature layer. Only the form item is updated. However, there are exceptions. The following table lists the changes you can make to a published survey that do not cause loss of data. N/A denotes a feature that is unavailable to add to the survey in this environment and cannot be changed.

Survey changesSurvey123 websiteSurvey123 Connect

Reorder questions

Yes

Yes

Delete questions

Yes

Yes

Update labels in questions

Yes

Yes

Update labels in groups

Yes

Yes

Add, update, or delete choices in lists

Yes

Yes

Update constraints, defaults, hints, and whether question is required

Yes

Yes

Update calculations and choice filters

N/A

Yes

Delete questions or repeats

Yes

Yes

Change question types

No

No

Add new questions

Yes

Yes

Add repeats

N/A

No

Add new notes

Yes

Yes

Update repeat name

N/A

No

Add groups

Yes

Yes

After saving changes to the survey, click the Publish button to republish it, after which your changes will be available to all users.

If your updated survey will change the feature layer where the responses are saved, you are warned and asked if you want to keep or delete records that have answers associated with the original schema that are now invalid.

Caution:

Once a survey that was created with the Survey123 web designer is modified in Survey123 Connect, you can no longer edit the portions of the survey that were edited in the XLSForm in the web designer. For example, survey questions and survey settings such as the thank you screen cannot be edited. Themes, webhooks, and sharing options can still be edited in the web designer.