> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Save chatter information using the Capture block

## Overview\[#UUID-7645cb1f-ad10-2f83-9389-f726708e723f_id_6319172609171_id_h_01G3EVW4W902AVZ3G3P4WAAN8K]

The Capture block takes information provided by a chatter and saves it
in a variable. You can then use that variable to tailor the chat
experience based on the chatter's specific details. This is an important
tool for creating real value in your chatters conversations.

> **Tip**
>
> To learn more about variables and how to use them, check out our
> [Variables guide](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/get-started-with-variables).

## Use the Capture block\[#UUID-7645cb1f-ad10-2f83-9389-f726708e723f_id_6319172609171_id_h_01G3EVWF9X3NY81E5AKD0T33MZ]

Insert a Capture block in an Answer when you need to record and work
with data directly from the chatter. You can use the variable it creates
in a range of other processes. This lets you tailor those processes
according to the information from the chatter.

For example:

* In a Conditional block to customize responses and actions based on the chatter's selection
* Transfer data to support ticket fields in a handoff block
* To simply address the chatter by name

If chatters don't have a piece of information required to continue through the Answer flow, your bot can serve an Answer called [Cancel Capture](/scripted/docs/build-and-maintain-your-bot/train-and-manage-answers/understand-your-bot-s-locked-answers#UUID-68a730a9-7de9-c197-7334-43460f68f14f_section-idm4681164663745633483033201876), which prompts them to ask about something else instead.

Place the Capture block at a point in an Answer where you need to gather
data from the chatter. Keep in mind that the Capture block must always
precede any blocks that are to use the variable it creates and
populates.

A Capture block can only capture one variable at a time. To capture more
than one variable, add a separate Capture block for each.

1. On the Ada dashboard, go to **Build** > **Answers** and open an
   existing Answer, or create a new one. Drag and drop a **Capture
   block** into the Answer editor.

2. Configure the Capture block using the table below as a guide:

<table>
  <thead>
    <tr>
      <th>
        Field
      </th>

      <th>
        Instructions
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Content**
      </td>

      <td>
        Add a message to this field requesting the information you want
        to capture.
      </td>
    </tr>

    <tr>
      <td>
        **Placeholder Text on the Chat Input** (Optional)
      </td>

      <td>
        Use this field to customize the placeholder text visible in the
        message field. Craft a brief instruction or example to help your chatters understand what information they should send.
      </td>
    </tr>

    <tr>
      <td>
        **Validation**
      </td>

      <td>
        Set the type of data the created variable will accept:

        * **Text** – Accepts any character type.
        * **Email** – Only accepts valid email addresses. Also verifies that the domain is valid, such as .com, .ca, etc.
        * **Phone Number** – Only accepts input formatted as a phone number, disregarding any letters or special characters.
        * **Number** – Only accepts numbers; allows periods and commas.
        * **Yes** and **No** – Only accepts a positive or negative response (e.g., yes/no, true/false).
      </td>
    </tr>

    <tr>
      <td>
        **Capture Settings**
      </td>

      <td>
        This section contains toggles that let you control
        the block's interaction behavior.

        **Always Ask**

        * Deactivated – The Capture block won't display for chatters if its
          variable is already populated. This ensures the bot only asks for
          specific information once, such as a chatter's name.
        * Activated – The block will always trigger whenever it is
          encountered, and overwrite any data that already exists in its
          variable.

        **Required**

        * Deactivated – A **Skip** button displays in the chat
          window. Clicking this allows the chatter to skip the Capture block and
          move on to the next block in the Answer.
        * Activated – A **Never mind** button displays in the
          chat window. Clicking this exits the Answer entirely, and directs
          the chatter to the Cancel Capture Answer instead.
      </td>
    </tr>

    <tr>
      <td>
        **Save Response As**
      </td>

      <td>
        Use the drop-down menu to choose the variable the Capture block
        populates with the captured data. You can select an existing variable,
        or create a new one.
      </td>
    </tr>

    <tr>
      <td>
        **Smart Detection** (Optional)
      </td>

      <td>
        Your bot can detect relevant information that returning chatters
        have provided in past conversations. Depending on your bot's configuration, this option may not be available.

        Click the **Select entity type** drop-down menu and
        select the relevant entity for this capture event. Click **Clear** to remove a previously assigned entity type (e.g., full name, city, airport, date or time,
        etc.)
      </td>
    </tr>
  </tbody>
</table>

3. At the bottom of the Answer editor, click **Save**.

   ![](/_fern-files/_img/04893eeea509dfde0a125b90a9f8050bae596be19b650e7dc789ad21fde7b3cc.webp)

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).