> For the complete documentation index, see [llms.txt](https://documentation.proto.cx/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.proto.cx/docs/modules/ai-agents/workflows-and-actions/show-survey.md).

# Show survey

`Action` — Each question and answer sent as a message uses one [interaction](/docs/getting-started/interactions.md).

## What it does

Runs a survey sequence, sending preset questions to the chat and collecting the person's answers. Questions and replies appear as regular messages. The person can optionally reply "skip" to move to the next question.

## When to use it

To gather structured information — contact details, a satisfaction rating, or qualifying questions — and store each answer in a variable for later actions to use.

## Settings

Press **Add field** to create a question. Configure each field:

| Setting                  | Description                                                                                                           |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| **Question**             | The message sent by the AI agent asking for the person's input.                                                       |
| **Answer must be**       | The required format of the person's answer: Text, Number, Attachment, Attachment(s), Email, or Phone.                 |
| **Invalid answer reply** | The AI agent's response when an answer fails validation.                                                              |
| **Chat variable name**   | Creates a [chat variable](/docs/developers/chat-variables.md) that stores the person's answer for downstream actions. |
| **Quick answers**        | Up to 13 clickable buttons below the question. Not supported on Bitrix24 or Africa's Talking channels. Optional.      |
| **Enable skip**          | Lets the person reply "skip" to bypass the question and move to the next one.                                         |

Press **Save** to confirm edits. To delete a field, press the delete icon in its header.

## Related

{% content-ref url="/pages/KpQiIGAmCVTGp5hdcACQ" %}
[Ask survey](/docs/modules/ai-agents/workflows-and-actions/ask-survey.md)
{% endcontent-ref %}

{% content-ref url="/pages/rTdnuIG08MgrRXkV3Alv" %}
[Set variable](/docs/modules/ai-agents/workflows-and-actions/set-variable.md)
{% endcontent-ref %}