> For the complete documentation index, see [llms.txt](https://docs.zigpoll.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zigpoll.com/polls/display-rules.md).

# General Settings

A quick overview of survey settings

#### Survey Title

The name of your survey. We recommend making this something that is easy to remember like "Homepage Survey" or "Checkout Survey"

#### Show Progress

By default we show a percentage on the top right of how far you are within a survey. You can remove this by flipping the switch.

#### Page Rules

When you create a survey, you are asked whether or not you want to show the survey on all pages. Generally, if you're not sure what this means or if you only have a single survey it's safe to just select **Show on all pages**.

If you select **Show on all pages** it means that this particular survey will show up all pages where your embed code is located.

{% hint style="info" %}
If you have multiple surveys that are set to Show on all pages the poll that is higher up on your [Active](/accounts/active-polls.md)[ Surveys](/accounts/active-polls.md) list will take precedence.
{% endhint %}

If you chose to enter specific display rules, you have the following options:

* Matches Exactly
* Match Variable
* Includes

These options allow you to build rules which can match any possible page configurations. Let's go through some use cases for each one.

#### Matches Exactly

Use this option if you want to match a specific page path. For example if you have a page at [www.mywebsite.com/product/beach-ball](http://www.mywebsite.com/product/beach-ball) and you want to show your "Beach Ball" Zigpoll on that page you would enter **product/beach-ball** into the input field under matches exactly.

{% hint style="info" %}
If you want to match the **homepage** **only** then use Matches Exactly and leave the input field blank and press "Update Survey".
{% endhint %}

#### Matches Variable

Use this option if you want to match a dynamic set of pages that all match a pattern one level deep.

For example: I want to show my "Product" Zigpoll on all pages that match [www.mywebsite.com/products/\*\*some-product-name](http://www.mywebsite.com/products/**some-product-name)\*\*. In order to do this I would select **Match Variable** and enter: **products** into the input box.

{% hint style="info" %}
You can have multiple rules for each page. So if you want to show the same poll on several different paths just add another rule.
{% endhint %}

**Starts With**

Use this option if you want to match a dynamic set of pages that starts with a certain pattern.

For example: I want to show my "Blog" Zigpoll on any page that starts with **/blog/** in the URL. I would want to use **Starts With** instead of **Match Variable** because I want to match **/blog/category/food** as well as **/blog/category/food/my-food-post** and **/blog/category/cars/my-car-post** etc...

{% hint style="info" %}
Use **Starts With** if you want to match any page that is located under certain URL path.
{% endhint %}

**Ends With**

Use this option if you want to match a dynamic set of pages that ends with a certain pattern.

{% hint style="info" %}
Use **Ends With** if you want to match any page that finishes with a certain URL pattern.
{% endhint %}

#### Exclusion Rules

If you want to exclude a path from rendering a survey then you will want to enable exclusion rules. Click this and then enter the paths which would be excluded from showing the survey.

#### Allow Resubmissions

If you enable this setting a visitor on your website will be able to resubmit the Zigpoll every time he or she visits the page. This is useful if you want to use Zigpoll as a Form.

For example, if you wanted to have a Contact Us form (like we do [here](https://www.snackpoll.com/contact)) you would want to allow your visitor to submit that form whenever they want regardless of whether or not they filled it out in the past.

#### Make Survey Unique Per Page

If you enable this setting the survey will be treated as unique depending on the URL it was accessed from. For instance if you have a checkout survey, you will want it to be unique depending on the URL it was accessed from (because order 123 is different than order 321).

### Activation Schedule

**Visibility Management** decides whether you switch the survey on and off yourself or let Zigpoll do it on a schedule.

* **Toggle the survey on and off myself** — the default. The survey stays exactly as you leave it.
* **Turn it on and off on a schedule** — set an activation date and time, a deactivation date and time, or both. The survey goes live and comes down automatically at those moments, in your local timezone.

{% hint style="info" %}
The Activation Schedule used to live on **Delivery → Timing**. It now sits here on **General**, with the rest of the survey's lifecycle settings.
{% endhint %}

#### Notify When Complete

If you enable this you will receive an email notification whenever this survey is completed.

#### Notification Recipients

By default the Account Notification Recipients (found under Account → Notifications) will be notified. If you would like to override this, flip the switch and enter the email addresses that should be notified when this specific survey has been completed.

#### Embed Settings

By default the survey will show up as a widget. If you would prefer to embed the Zigpoll directly onto your page. Then you will want to select **Embed on your page**. Once you do this you will be prompted to add a selector. This selector should be a [valid CSS selector](https://www.w3schools.com/cssref/css_selectors.asp) that points to the element where you want the survey to show up.

## More Options

Under **Survey Rules**, open **More Options** to fine-tune how the survey interacts with participants once it is showing.

### Anonymous Mode

When enabled, Zigpoll will not collect any identifying information from participants. This is useful for surveys where you want to guarantee respondent privacy.

### Tap Outside to Close

Allow mobile users to close the survey by tapping outside of it. This provides a more natural dismissal experience on touch devices.

### Hide X Button

Hides the X (close) button on the top right corner of the survey. Use this when you want to prevent users from dismissing the survey without completing it.

### Auto Focus Inputs

Control which inputs are automatically focused when a question becomes visible:

* **All Inputs** (default) — Automatically focus the first input on every question
* **Required Inputs Only** — Only auto-focus inputs on required questions
* **Disabled** — Never auto-focus inputs

### Hide Close Button

Hides the close button that appears at the end of the survey. This is useful if you want participants to remain on the final question rather than dismissing the survey.

### Hide Back Button

Prevents the back button from appearing on the survey. Use this when you don't want participants to revisit previous questions.

### Hide Optional Labels

Hides the "Optional" label that appears next to optional questions in your survey. This is useful if you want a cleaner look without indicating which questions can be skipped.

### Reset Session

Each survey completion will be treated as a brand new participant. This is useful for **kiosk-style** setups where you want to collect feedback from multiple people using a single device (e.g., a tablet at a checkout counter).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.zigpoll.com/polls/display-rules.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.