# Deploying Your Survey

Before deploying, make sure your survey is active. Go to the Survey Dashboard and click **Activate Survey**, then type **ACCEPT** to confirm. The survey status will change to Active and the Live Survey URL will become accessible.

<figure><img src="/files/BEc7SpIumZVlAGvWxYkf" alt="A screenshot of the Survey Dashboard, showing the Activate Survey button."><figcaption><p>The Survey Dashboard, showing the Activate Survey button.</p></figcaption></figure>

Note that the Live Survey URL is generated when the survey is created and does not change, however it will not work until the survey is activated.

***

### Survey Link

Every survey has a Live Survey URL accessible from the Survey Dashboard. You can share this link in a regular email, add it to your website, or embed the survey using the **Get Deployment Code** options.

<figure><img src="/files/aVm7gqMU0tC0jRxsA8PY" alt="A screenshot of the Deploy Code screen showing the three embedding options — standard link, popup window, and inline frame — with the generated code displayed below."><figcaption><p>The Deploy Code screen showing the three embedding options — standard link, popup window, and inline frame — with the generated code displayed below.</p></figcaption></figure>

Responses collected via a plain link are recorded as anonymous. All you know about each respondent is what they answered in the survey.

***

### Sending via a UbiQuity email

Sending your survey via a UbiQuity email unlocks significantly more capability. When a respondent clicks the personalised link in a UbiQuity email, their response is linked to their database contact. This gives you the ability to:

* Send reminder emails only to contacts who have not yet responded
* Filter your database based on survey responses
* Merge database fields into the survey and triggered emails
* Use database fields in survey logic

To deploy via a UbiQuity email, ensure your survey is active, then create a mailout and use the Insert UbiQuity Link button to insert the survey link into your email content.

<figure><img src="/files/NF6fUwdKHsBvrWoddOkT" alt="A screenshot of showing the insert UbiQuity links button."><figcaption><p>Use the highlighted button to insert UbiQuity links.</p></figcaption></figure>

***

### Previewing Before You Deploy

Before activating and sending, use the **Preview Your Survey** option from the Survey Dashboard to test the survey. You can preview anonymously using the Preview Survey URL, or preview as a specific database contact to test merge fields and logic.

<figure><img src="/files/orRJvi13EC37XxQJVSRr" alt="A screenshot showing the ability to preview your survey as an anonymous recipient, or as a specific database contact."><figcaption><p>Preview your survey as an anonymous recipient, or as a specific database contact.</p></figcaption></figure>

Preview responses are kept separate from live responses and will not appear in your reports. Triggered emails will not fire during preview.

**Testing checklist before you go live:**

* Test the full survey from start to finish
* Test all show/hide logic and page branching paths
* Check the Inactive page is set up correctly
* Set a close date if applicable


---

# 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/deploying-your-survey.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.