> 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/questions/types-of-questions.md).

# Types of Questions

Learn about all the different types of questions at your disposal.

There are currently 26 types of questions. Each type behaves differently and was built to help you collect the right data from your customers and site visitors.

All of the options allow you to enter a Title, Subtitle, and Body Copy.

The rest of this doc dives into each type of question, how it can be used, and an example picture. We recommend hopping into Zigpoll's free plan and experimenting with different questions yourself!

#### Multiple Choice

This type lets you create several answer options. Your customer can pick one or more.

Once the customer submits the answer, the results can be shown (this is optional, you can hide it if you prefer by deselecting **Show Results**). You can have as many answers as you like.

You can also add a **Write-in Answer**: a last option where people type their own response. What they type is collected and shown with the other answers on the dashboard.

**Randomize answers** (in the question's settings) shows the options in a different order for each respondent, which removes the bias toward whichever answer sits first. It is available on Single Choice, Multiple Choice, Dropdown, Autocomplete, Binary choice, Image Choice and Ranked Choice questions, and it works on Shopify Thank You and Order Status page surveys as well as on-site. A write-in answer stays last. Matrix questions have their own **Randomize Rows** and **Randomize Answers** switches, described below.

You can also lay the answer options out in up to **4 columns** using the **Layout** setting (available on Multiple Choice and Single Choice questions).

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-6ff02cc6c61c49135e1e2997df94169fa5b5cd1f%2Fquestion-type-multiple-choice.png?alt=media" alt="A Multiple Choice question" width="444"><figcaption></figcaption></figure>

#### Single Choice

This type lets you create several answer options. Your customer can pick one.

Once the customer submits the answer, the results can be shown (this is optional, you can hide it if you prefer by deselecting **Show Results**). You can have as many answers as you like.

You can also add a **Write-in Answer**: a last option where people type their own response. What they type is collected and shown with the other answers on the dashboard.

Like Multiple Choice, Single Choice supports the **Layout** setting to lay options out in up to 4 columns.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-3bd545ea863eee947c7b1ade7d952c5e6e8128cd%2Fquestion-type-single-choice.png?alt=media" alt="A Single Choice question" width="444"><figcaption></figcaption></figure>

#### Dropdown

A single-select question presented as a compact dropdown menu. Ideal when you have many options but want to keep the question visually small.

#### Mosaic

A multiple-choice question where the answer options render as a tiled grid directly in the question, letting respondents tap selections quickly. Great for visual, fast-moving surveys with many short options.

#### Autocomplete

A single-select question with a searchable, type-ahead input. As the respondent starts typing, the list of answer options filters down to matches.

This is ideal when you have a long list of choices — for example a product, store location, or brand — that would be unwieldy as a dropdown or a list of multiple-choice options. You can add as many options as you like, and (like Single Choice) include a **Write-in Answer** that lets respondents type in their own value.

#### Matrix

Ask several questions that share the same set of answer options, laid out as a grid: each **row** is a question and the **columns** are the shared choices. Respondents pick one option per row, or several per row if you turn on **Multiple selections**.

This is ideal for rating multiple items on a single, consistent scale — for example rating Shipping, Packaging, and Support each as "Poor / Okay / Great" in one compact question instead of three separate ones.

Each row is reported as its own breakdown on your dashboard, just like a Single Choice question, so there is no extra work to analyze the results. You can optionally enable **Randomize Rows** and **Randomize Answers** to shuffle the rows and columns (pin any you'd like to keep in place), and the whole question can be marked optional.

**Multiple selections** (in the question's Settings, or the Rows menu) turns the grid's radio buttons into checkboxes so a respondent can pick more than one answer in each row — for example "Which of these have you used?" across several products. A row still needs at least one pick unless the question is optional, and **Selections per row** (shown once Multiple selections is on) lets you require at least, exactly, or at most a number of picks in every row. The Matrix input inside a **Form** has the same Multiple selections toggle, without the per-row rule. Your results then work the way a Multiple Choice question's do: each row's percentages start as the **share of answers** in that row, and clicking a percentage switches to **penetration rate** — the share of respondents who picked that answer, where a row can add up to more than 100%. The question also gets a **Selections** count beside **Answers**. In exports and integrations a row with several picks reads `Row: Answer + Answer`.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-1944681f1d33d8ffd6d0f4e1568a3cb76a7f654d%2Fquestion-type-matrix.png?alt=media" alt="A Matrix question" width="444"><figcaption></figcaption></figure>

#### Short Answer

Write-in in a single line box. You can set placeholder text or fine print.

Once you have enough volume of write-ins, Zigpoll will help with summarizing themes and responses.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-bb6ba8493d032834de672d6a880dde67a8e8541c%2Fquestion-type-short-answer.png?alt=media" alt="A Short Answer question" width="444"><figcaption></figcaption></figure>

#### Long Answer

Write-in in a multi-line box. You can set placeholder text or fine print.

Once you have enough volume of write-ins, Zigpoll will help with summarizing themes and responses.

**File uploads** (in the question's Settings, under Answering) lets respondents attach files to what they write. The text box gains an attach bar along its bottom edge, so a "Describe the issue" question can take a photo or a receipt without a second question. Attaching is always optional, and an answer still needs some text: files on their own are not accepted. Turn on **File types** beneath it to accept only certain kinds of file.

The files are kept with the answer. On the Answers and Participant pages they appear under the text, as links (images open in place). In exports and integrations, where an answer is one value, it reads `the text [Files: link, link]`, and notification emails list each file as a link. Logic rules, sentiment and AI summaries read the text only.

In the Shopify checkout and thank-you page extensions the question shows as a plain Long Answer, without the attach bar.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-92080fdb544a7fd04ba4615b66180ff1e3176e6f%2Fquestion-type-long-answer.png?alt=media" alt="A Long Answer question" width="444"><figcaption></figcaption></figure>

#### Binary choice

Useful if you want a "Yes/No" answer between two choices.

For example: "Are you buying this for someone else?"

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-8d82c9cd3f1fb26ac3dac84065cc927b0b34efa9%2Fquestion-type-binary-choice.png?alt=media" alt="A Binary Choice question" width="444"><figcaption></figcaption></figure>

#### Form Panel

A question that allows you to have multiple fields. These are best used for "contact us" or support forms.

When creating each field within a form panel, you have the option to set the type of question (email, long answer, phone number, date etc.) and whether the field is optional or required.

When filled out, the responses will be grouped together on your dashboard for convenience.

A **Long Answer** field has a **File uploads** switch. Turn it on and the field becomes one box: the text area, with an attach bar along its bottom edge. Attaching is optional even when the field itself is required, and **File types** beneath the switch limits what is accepted. The files are recorded as their own answer, named after the field ("Question/Comment Files"), and it is left out wherever the form's answers are listed if nothing was attached. In the Shopify checkout and thank-you page extensions the two show as separate fields, a text area followed by an optional file upload.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-91d890d38bcf0d8ba2254a29b12c37145039bd52%2Fquestion-type-form-panel.png?alt=media" alt="A Form Panel question" width="444"><figcaption></figcaption></figure>

#### File Upload

File uploads let respondents upload files, and you can restrict the number of files allowed, file type, and max file size. This can be useful for wholesale use cases, support, or for custom designs!

The **Max file size** you set applies per file, and the ceiling is **20 MB** per file whatever the setting. **File types** takes a list of extensions; leave it empty to accept anything, or list the types you want, for example `jpg, png, heic` for photos or `mp4, mov` for video. When only image or video types are listed, phones open the photo picker directly instead of the general file browser. File Upload is available on every plan.

File Upload isn't available on [Shopify POS](/installation/activating-zigpoll-on-shopify-pos.md) surveys, since the register has no file picker; it's hidden from the question picker when a survey uses a POS delivery template.

Additionally - if you would like your user to take a picture, enable the "mobile auto-capture" field. When enabled the camera will pop up on mobile devices automatically for a streamlined experience. This will limit the number of files accepted to 1 file only. Great when you're expecting photos or UGC content.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-a5610e81ea2743f54ae4e7a8efe31b90246898ee%2Fquestion-type-file-upload.png?alt=media" alt="A File Upload question" width="444"><figcaption></figcaption></figure>

#### Image Choice

Upload a set of images to allow customer to pick from. Can upload unlimited images in theory, but best to cap it at 6.

The **Selections** setting controls how many images must be picked, and the image columns setting how many are shown per row. (Image Choice columns are separate from the **Layout** setting on choice questions and have no 4-column cap.)

Best used for product/design feedback or to see whether respondents remember a particular ad creative — for example, testing ad recall on channels like TV.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-bedac479b7be20fee588640e206da4e1c43d0f72%2Fquestion-type-image-choice.png?alt=media" alt="An Image Choice question" width="444"><figcaption></figcaption></figure>

#### Consent

Useful if you want to opt-in users for marketing communications or Terms & Services.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-52ee812e2f6d420a2662577d95e7733756052a1e%2Fquestion-type-consent.png?alt=media" alt="A Consent question" width="444"><figcaption></figcaption></figure>

#### Country

Allow respondents to select from a list of countries.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-9771e8618a68f84980b12b86b4339b69f12fc71c%2Fquestion-type-country.png?alt=media" alt="A Country question" width="444"><figcaption></figcaption></figure>

#### Date

Let respondents pick a date — useful for capturing birthdays, delivery dates, or event dates for follow-up.

The answer is stored as the calendar day the respondent picked (for example `2026-09-14`), with no time or time zone, so it reads the same in your dashboard, exports, and integrations no matter where the respondent is.

#### Star Rating

This type is useful if you want to get a 1-5 rating from your customers. The UI is large, colorful, and simple to optimize engagement, and you can customize the labels.

*For example: How would you rate our support?*

Two settings control the look:

* **Type** — rate with **Stars** or **Hearts**.
* **Style** — choose from over a dozen illustrated styles: Default, Emoji, 3D, Anime, Clay, Comic Book, Crystal Glass, Hand Drawn Doodle, Holographic, Oil Painting, Origami Paper, Pixel, and Watercolor.

When a respondent picks a rating, every star up to their selection fills in — so a 4-star answer shows four filled stars, not just one.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-c09fef74385b3aeb0b97fb8a1875626a6924f7f3%2Fquestion-type-star-rating.png?alt=media" alt="A Star Rating question" width="444"><figcaption></figcaption></figure>

#### Slider

Useful for a scale measurement of a metric.

You have the ability to change labels, change the increment of the slider.

If you want the slider to represent options 10,20,30... you would set increment to 10.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-42a895adbec9745930c4100a059dd9a127a46ac6%2Fslider-answer-options.png?alt=media" alt="Slider answer options: range and increment" width="681"><figcaption></figcaption></figure>

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-6c3872d58a93c12528968c8d2ee4602e4c734bd9%2Fquestion-type-slider.png?alt=media" alt="A Slider question" width="444"><figcaption></figcaption></figure>

#### Email Capture

This will create an email capture form. The user is required to enter his or her email before proceeding with the survey.

{% hint style="info" %}
The emails will be saved to your account and can be exported into your mailing list at any time.
{% endhint %}

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-ee296d50f60dbe8a59eb6a41e3afd2e795ca9fb7%2Fquestion-type-email.png?alt=media" alt="An Email question" width="444"><figcaption></figcaption></figure>

#### Phone Number

Collects a phone number using a specially formatted input that validates and formats the number as the respondent types. Useful for follow-up, SMS opt-ins, or support.

Set a **Default Country** in the question editor to pre-select the country code most of your respondents will use. Phone fields inside a Form question have their own Default Country setting and fall back to the question's default when none is set.

{% hint style="info" %}
Like email capture, collected phone numbers are saved to your account and can be exported at any time. You can also send SMS survey invitations to these numbers.
{% endhint %}

#### Range

Create a list of inputs from 1-10. This type is useful if you want to do a heat check on a new feature.

*For example: How do you like our new feature from 1-5?*

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-87c2977c51a191e72a79e73175c0dc5b0620ec83%2Fquestion-type-range.png?alt=media" alt="A Range question" width="444"><figcaption></figcaption></figure>

#### Satisfaction

This is another useful type for capturing user feedback. It is more limited in that you only have five emotions, but it can be helpful for getting a quick reaction to a new feature.

*For example: How satisfied are you with our return policy?*

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-eba8210e9a0245e0b60c0d043f09a08c9b5dcbd4%2Fquestion-type-satisfaction.png?alt=media" alt="A Satisfaction question" width="444"><figcaption></figcaption></figure>

#### Promo Code

Add a question that displays a discount code!

Full tutorial below

{% content-ref url="/pages/Unv1KnjO66PubFN1WBCb" %}
[Adding discount codes to your survey](/tutorials/adding-discount-codes-to-your-survey.md)
{% endcontent-ref %}

#### Actions

Actions were designed to send respondents to another link. This is particularly useful if you want to send them to social media platforms, another page on your site, or to leave a review.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-a4a685fb4724a8bb10fdb8f50928fa7238826043%2Fquestion-type-actions.png?alt=media" alt="An Actions question" width="444"><figcaption></figcaption></figure>

#### Text & Image

A content-only question (no question) that displays a title, copy, and optionally an image. Use it to introduce your survey, add context between sections, or make an announcement.

#### Thank You

A closing content question shown after the survey is complete. Use it to thank respondents, set expectations for follow-up, or point them somewhere next.

{% hint style="info" %}
All responses will be saved to your dashboard and can be exported at any time.
{% endhint %}

#### Ranked Choice

Let respondents rank from a set of options. You can set the minimum number of answers you want to be ranked.

<figure><img src="https://1643988190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZpanNFqg3aCUZgXh3X%2Fuploads%2Fgit-blob-b6bd787d9f6f455dd605ac67126d8004626f689e%2Fquestion-type-ranked-choice.png?alt=media" alt="A Ranked Choice question" width="444"><figcaption></figcaption></figure>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.zigpoll.com/questions/types-of-questions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
