Settings

The settings sheet of the XLSForm contains options that control the presentation and behavior of your survey.

Form title

The form_title column defines the name that is displayed in the title area of your survey.

Alternatively, you can define your survey's title by including a note question in your survey named generated_note_form_title. This method allows you to provide translations for the title and include values from the survey response in the title using the ${question_name} syntax. For more information, see Customize form elements.

Note:

This title is not used in the gallery of surveys or on the Download Surveys menu. The title used in these locations is defined in Survey123 Connect on the Details tab.

Form ID

The form_id column defines the name of the target layer in the feature layer that will be created (or connected) to store the answers of the survey. If this column is empty, Survey123 provides a form ID with the same name as the XLSForm file name. If a feature layer will be created when you publish your survey, the name of the feature layer will match the form ID. If at the time of publishing you are instead connecting your survey to an existing feature layer, the layer that matches your form ID will be connected to your survey.

If your survey has repeats, the feature layer will contain a feature layer and one or more related tables. In this case, the form ID will reference the parent feature layer name. The related tables are not referenced by the form ID.

When creating a survey from an existing feature layer, you can use the form ID to reference a specific feature layer or table. For example, you can create a survey specifically for a related table—such as a table of inspection records. In this case, enter the name of the table in the form_id column.

Note:

To generate a survey from a related table in a feature layer, you must first generate the XLSForm from the full feature layer; then delete the questions that refer to the parent feature layer. Remove the begin repeat and end repeat rows and enter the name of the repeat in the form_id column.

Instance name

The instance_name column defines the information used to uniquely identify survey responses in the Survey123 field app. For more information, see Instance name.

Submission URL

The submission_url column defines an existing feature layer where your survey responses will be submitted. To send results, this feature layer must be accessible to both the owner and users of the survey. For more information, see Use Survey123 with existing feature layers.

Default language

The default_language column defines the language your survey will initially use. Defining the language by language code is recommended, though not required; however, you must define the language in the same way throughout the survey. For more information, see Manage multiple languages.

Version

The version column defines the name or number of the current version of your survey. You can reference this version in a survey question using the version() function in the calculation column, and it appears in your survey's contents page if a version has been defined. This is useful for indicating that you have updated your survey.

Note:
A survey's version is manually specified by the survey author as required and does not change or increment automatically.

Style

The style column defines styles that will be applied across your entire survey. To function, these styles require you to provide additional values in the appearances column. For more information, see Appearance.