> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instantcampaign.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Polls

> Ask readers a question in an email and let them answer with one click.

The **Poll** block puts a question in your email with two to six answers. Each answer is a link, so readers can answer in any mail app, on any device. One click records the answer and opens a thank-you page.

## Add a poll

1. In the email builder, open the **Media** group and add **Poll**.
2. Type your question.
3. Edit the answers. Each answer has a label and an optional emoji. Add up to six, remove down to two, and change their order.
4. Pick a layout: **Buttons** (one answer per row) or **Emoji tiles** (tiles side by side).
5. Optionally write a thank-you message. Leave it blank to use the built-in one, shown in the reader's language.
6. Choose whether the thank-you page shows the results so far.

You can also set the question colour, button colours and text sizes.

## What a reader sees

When someone clicks an answer, their browser opens a short thank-you page with your workspace branding. If you turned on results, they see bars with the share of each answer.

Each person has one answer per poll. If they click a different answer later, the new one replaces the old one and the thank-you page says so.

Polls work in campaigns and automation emails. In previews and test sends the answers don't record anything, because there is no recipient to record them for. Transactional emails sent through the API don't support polls.

## Save the answer on the contact

An answer can also update the contact, the same way a [quiz question](https://docs.instantcampaign.ai/guides/audience-and-campaigns/quizzes-targeting-ab-tests.md) does. For each answer you can:

* set an option of a custom field
* set a yes/no field
* add the contact to a list
* set how often they want to hear from you

If someone changes their answer, the new answer's updates are applied. The earlier answer's updates stay: a list they joined stays joined.

## See the results

Results appear on the campaign page, on the campaign report, and in an automation's analytics panel once the email has a poll. For each poll you see the number of answers, when the last vote came in, and a bar for each answer with its votes and percentage.

## Follow up on an answer

Next to each answer, click the segment button to create a segment of everyone who gave that answer. The segment opens straight away, and you can send to it like any other segment.

Every answer is also recorded as the event `poll_answered`, with the poll's id and the answer's id (`optionId`). You can use it to:

* **Start an automation**: use an event trigger with the event name `poll_answered`, then add a Condition step on `data.optionId` to send different emails for different answers.
* **Build a segment by hand**: add a **Custom event** rule for `poll_answered` with **Has occurred**.

## Merge tag

Each answer links to `{{poll_url}}`, which InstantCampaign fills in with a personal link for every recipient when the email is sent. You don't need to add it yourself. The Poll block does it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.