Skip To Content

Print survey results

In addition to the option to print the analyzed results of your survey (see share survey results), the Survey123 website can also display and print the data from an individual survey response.

Print survey responses

On the Data page of the Survey123 website, you can use the data table to view all collected records in your survey. You can also open the survey responses in the Map Viewer in ArcGIS Online, or download the survey data in a number of formats.

An individual survey response can be highlighted by selecting either its entry in the data table or its point on the embedded map view. This opens the individual response panel, displaying the information from the survey as it was entered, in groups if they exist (repeats do not display). Use the Print button in the individual response panel to print the individual response.

Report templates

If the default format of the printed survey doesn't suit your needs, the Survey123 website also provides a Report Template feature that provides a personalized template that will be applied to your survey responses.

A report template is a Microsoft Word (.docx) file that provides placeholder text with specific syntax. When printing a response, this placeholder text will be replaced with the contents of the corresponding fields from the survey response. This placeholder text can be used with any formatting, tables, images, or other personalization to create a template specific to your survey's needs.

To apply a new template, click the Report button on the bar above the map on the Data tab, and then click Manage Templates. A new window appears allowing you to either select an existing template if one exists or upload a new one. Click Upload New Template to open another new window where you can provide the placeholders for your survey's fields and a name and summary for your template when uploaded.

You can copy and paste the field name codes into the appropriate place in your template document. Alternatively, a link is provided to download a sample template based on your survey. Once a template has been chosen, click Generate to create your report.

Expressions

Expressions can be included for certain types of questions to display the response in a particular format other than the default. For applicable questions, a Show more options button is available next to their placeholders in the Report Template window.

Images

For image questions, sizes can be set to ensure your printed responses have images of consistent size. The format for these expressions is as follows:

${image|size:width:height:max_width:max_height}

The width and height values control the set size of your image, measured in pixels. While these values are required for the expression, providing a value of 0 will place no restriction on that dimension of your image. For example, the following expression would force the width of your image to be 300 pixels, while preserving the aspect ratio of the image:

${image|size:300:0}

The maximum height and width values limit the maximum size of an image and are optional values. The following example forces the width of the image to be 300 pixels but restricts the image height to no more than 200 pixels:

${image|size:300:0:0:200}

Image questions can also have image details extracted and displayed in a survey response. This can be used to display the file name and size of the image.

${image1|getValue:"name"}

${image1|getValue:"size"}

${image1|getValue:"width"}

${image1|getValue:"height"}

The same method can also be used to display EXIF data from the image, showing details of where and when a photo was taken.

${image1|getValue:"x"}

${image1|getValue:"y"}

${image1|getValue:"date"}

${image1|getValue:"time"}

${image1|getValue:"direction"}

Geopoints

For geopoint questions, expressions can be used to display the latitude or longitude values from the question.

${location|getValue:"x"}

${location|getValue:"y"}

It isn't possible to display both values with one expression; if both values are needed, both expressions must be used.

Geopoint questions can also support setting the webmap item ID and map scale as optional parameters by preceding the values with mapSettings:.

${location|mapSettings:"10df2279f9684e4a9f6a7f08febac2a9":264800}

Leaving either of these values blank will use the default, allowing you to define a webmap or map scale without defining the other.

Date, time and date-time

For date and date-time questions, an expression can be used to format the date using DD, MM, and YYYY placeholders for day, month, and year, respectively. The following expression displays only the day and month, omitting the year:

${date|format:"DD/MM"}

It's also possible to format the time in date-time questions, using HH, mm, and SS as placeholders for hours, minutes, and seconds, respectively. The following expression displays the day, month, hours, and minutes:

${datetime|format:"DD/MM HH:mm"}

By default, all date and time values stored in a feature service are displayed in Coordinated Universal Time (UTC). The utcDefault parameter can be used to alter the display of these values in a report, to match a specific time zone. The following expression displays the response to a time question offset from UTC by one hour.

${time|utcOffset:"+01:00"}

The utcOffset parameter supports the formats +01:00, +0100, and +01 and will return the same result. This parameter can also be used to alter the display of the response submission time.

Multiple-choice

For both select one and select multiple questions, an expression can be used to place a check box next to a choice item, which is filled depending on the response to the question. The following expression displays whether or not the yes option has been selected for a question:

${select_one|selected:"yes"} Yes

Select multiple questions also have a supported expression to return all selected choice items as a bulleted list.

${select_multiple|appearance:"bullets"}

Repeats

The values in a repeat can be accessed if placed between expressions using the repeat's name as a placeholder. The ${#repeatname} placeholder denotes the start of a repeat named repeatname, while ${/repeatname} denotes the end. Placeholders pointing to questions within the repeat behave as normal, but the question placeholders must be within the placeholders of their repeat.

Limitations

The following limitations currently exist when using report templates:

  • You can't determine the zoom level of your map through your template. As a workaround, the map display in the Survey123 website report preview can be used to set the zoom level in your printed result.
  • You can only print individual records. Batch printing is intended to be added in the future.
  • On-premises installation only supports report templates in ArcGIS Enterprise 10.5 and later.
  • Photos submitted for image questions are not supported with an on-premises installation.