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 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 file (.docx) 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 click Manage Templates. A new window appears, allowing you to either select an existing template 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 in 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:

${image1|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:

${image1|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:

${image1|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 web map 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 web map or map scale without defining the other.

If a geopoint question is not part of your survey, or you're creating reports for feature services without an associated survey, the geometry of a question can still be returned using the ${$shape} placeholder . This can also be used to return the geometry of polyline and polygon features.

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"}

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 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 perform as expected, but the question placeholders must be within the placeholders of their repeat.

Conditional elements

Elements of a report can be shown or hidden conditionally using if statements. The if statement can be used by typing an expression in the starting ${if expression} placeholder, with ${/} denoting the end of the conditional segment. Some examples of if statements that could be used to hide parts of a report are as follows:

  • ${if photo1} would display the section only if the photo1 question has been answered.
  • ${if integer1>0} would display the section only if the answer to the integer1 question was a positive number.
  • ${if ((geopoint1 | getValue:"y")>0)} would display the section only if the geopoint is in the Northern Hemisphere.

The following logical operators are supported in if statements:

OperatorDescription

||

Returns true if one of two statements returns true

&&

Returns true if both given statements return true

!

Returns true if the statement does not return true

==

Returns true if the two given values are equal to each other

!=

Returns true if the two given values are not equal to each other

>

Evaluates if the first value is greater than the second value.

>=

Evaluates if the first value is greater than or equal to the second value

<

Evaluates if the first value is less than the second value

<=

Evaluates if the first value is less than or equal to the second value

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