# Responses and Reporting

### Viewing Responses

You can access survey responses from three places:

* From the main Surveys dashboard, click the **number of responses** shown against the survey
* From the Survey Dashboard, click **View Responses**
* From the Survey Summary on the Survey Dashboard, click the **Total Responses** figure

Responses can be filtered by status and type. Status options are Complete (the respondent finished the survey and saw the Thank You page), Incomplete (the respondent started but did not finish), and Both. Type options are Live (responses from the live survey URL) and Preview (responses recorded during testing).

Click **Show Responses** to display the response list.

<figure><img src="/files/oOG5P0dTO4F5dJRj5bEh" alt=""><figcaption></figcaption></figure>

***

### Editing Responses

Super Users and Survey Administrators can edit individual responses. To edit a response, click the three dots beside it, then **View** and then **Edit**. If triggered emails are set up, UbiQuity will ask whether you want them to be resent when saving the edited response.

***

### Filtering Responses

From the Responses page, click **New filter** to filter responses by survey question answers. If the survey was deployed via a UbiQuity email, you can also filter by database fields and by how contacts interacted with the email, such as whether they clicked a specific link.

<figure><img src="/files/V11lH10JLk7gA6KdMros" alt="A screenshot of the filtering options available for Survey responses."><figcaption><p>The filtering options available for Survey responses.</p></figcaption></figure>

***

### Downloading Responses

Click the three dots to the left of **Show Responses** to Download Responses from the Responses page and choose your file format. CSV works well for most purposes. If your survey was deployed via UbiQuity Mail, you can choose to include database fields alongside the survey responses in the download, giving you a complete picture of each respondent against each row.

<figure><img src="/files/aYS117lwRQyxlUzoMXay" alt="A screenshot showing the download responses option."><figcaption><p>The download responses option.</p></figcaption></figure>

***

### Response Source

UbiQuity records the source of each response. Anonymous responses come from a plain link on a website or in a standard email. Mailout responses are linked to the UbiQuity mailout they came from. Keyed in responses are entered manually by clicking **Respond to Your Survey** from the Survey Dashboard.

***

### Responding on Behalf of a Contact

You can enter a live response on behalf of a database contact by clicking **Respond to Your Survey** from the Survey Dashboard and selecting a contact. This has the same effect as if the contact had clicked a personalised link from a UbiQuity email, and the response will appear in that contact's history.

***

### Passing Data via URL

If you are deploying your survey outside of a UbiQuity email and want to pass additional information into responses, you can append up to three data parameters to the survey URL using data1, data2, and data3. These values appear against each response, in reports, and in download files, and can also be used in filters and survey logic.

***

### Reports

Each survey has a default report that shows every question. Access it from the Survey Dashboard by clicking **View Default Report**.

<figure><img src="/files/Liu4MC8WEu2xhBkArowP" alt="A screenshot showing an example of a default survey report."><figcaption><p>An example of a default survey report.</p></figcaption></figure>

To create a custom report, click **Manage Reports** from the Survey Dashboard. You can create a report from scratch or copy the default report as a starting point. Add pages and questions from the survey using the Add Page Item dropdown. You can also add sections to include formatted text, images, or video alongside your charts.

For each question added to a report, click the edit icon to change the chart type, display format, and whether statistics are shown. Questions can be added multiple times with different settings.

<figure><img src="/files/XWSkSdY3PAe5fwCzmUfW" alt="A screenshot showing an example of the custom report builder."><figcaption><p>An example of the custom report builder.</p></figcaption></figure>

To share a report with someone who does not have a UbiQuity login, tick **Report is public** in **Report Details**. This generates a shareable link. Note that the report is not published anywhere publicly, but the link could be shared further, so consider whether the content is appropriate to share openly before distributing it.

If the survey was deployed via a UbiQuity email, you can also filter reports by database contact fields.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ubiquity.co.nz/documentation/data-capture/surveys/responses-and-reporting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
