> 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.

# Serve content using Message blocks

## Overview\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_bc6e441c-79f5-4b6a-bec7-5dc592a68677]

Answers in Ada are built using content blocks that provide your
customers with a rich chatbot experience. Each block acts as a single
bubble in the chat, and can be combined in infinite ways to create
Answers tailored to your audience. The content blocks available within
your bot will vary based on your package. There are many different types
of content blocks. Let's take a look at the most commonly used types!

## Text Message block\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_42774a25-b46d-4c4d-b7fa-ba569c079354]

The Text block delivers simple text messages to your chatters. Each
Text block appears as a single chat bubble, and can contain up to 320 characters.

You can add emojis and line breaks to give your Text blocks some personality and formatting 😎

![](/_fern-files/_img/cbe2f36c466fc9a0233c2485df57427b3df876ec12a8dc1ee6c7e1978ab10862.webp)\
![](/_fern-files/_img/04c03e9b9a109cbb55d1a0f397ddceaf7c689f84ce56fdd5934abacc31743dce.webp)

### Use AI to improve your text content\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_section-idm4525745285073633567739381339]

Any time you serve up content using the Text block, no matter which of
Ada's supported languages you're writing in, you have the option to
polish it with AI. You can click the **Improve** button ![](/_fern-files/_img/8ced97060689039623375bbc5a33ac8335fe81b2273c2668a9310d616d09fc3e.webp) to
automatically run your content through GPT and replace it with a
rephrased version with improved tone. Even after improving your content
automatically, you can always go back and edit it yourself until you're
happy with it.

![](/_fern-files/developers.ada.cx/49c102102569946a2a1fe1a5a2f303d3eb0370cf524c5990ba65a7d3fb6e584b/ada.docs.buildwithfern.com/2025-05-28T19:49:52.708Z/versions/assets/image/uuid-4b6f45cb-929c-3319-14b9-2524c8aa0952.gif)

If you'd rather not use the automatically rephrased version of your
content, you can click **Undo** in the notification that appears at the
bottom of your screen to reverse it.

### Add variations to your text content\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_ba6fd3d8-f151-4866-8d2d-24aec86d0429]

You can also use the Text block to create variations of the same message so you can keep your content fresh. Your bot will randomly select a variation to send to your chatter, and you can either write your own variations or generate them with AI.

We recommend using variations with content that is likely to show
up repeatedly in a single conversation. For example, adding different versions of "hi" or "hello" in the Greeting will give your bot more personality and prevent the conversation from feeling robotic.

If your shuffled message contains essential information, make sure that
information is in every variation — otherwise, only random chatters will
get the important message!

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

### Use AI to create message variations\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_section-idm464312673620483356779743137]

To start creating content variations for your bot to shuffle between,
start typing a message into your block. If you want, you can use the **Improve** button ![](/_fern-files/_img/8ced97060689039623375bbc5a33ac8335fe81b2273c2668a9310d616d09fc3e.webp) to refine
your initial message.

Then, you can use the **Create variations** button to use GPT to
rephrase your content into 3-5 variations for your bot to randomly serve
to chatters - in any of Ada's supported languages. All of these
automatically generated variations are editable and removable, so you
can further refine the variations you get from the AI. You can also
click **Add manually** to write additional variations yourself.

![](/_fern-files/developers.ada.cx/73d46f6b2245c7ebf6f33d402a8be069a5cb90899263d0c5c0766bd841e96e35/ada.docs.buildwithfern.com/2025-05-28T19:49:52.708Z/versions/assets/image/uuid-4fa4c84c-9761-74a7-db52-10ba11ae44e7.gif)

## Link Message block\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_4193a258-8484-42b3-833a-8fb231d97701]

With Link blocks, you can add links to your chat, so you can direct chatters to websites like in-depth support articles, or give them the opportunity to communicate with your organization's support team directly.

Configure the Link block using the table below as a guide:

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

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

  <tbody>
    <tr>
      <td>
        **URL**
      </td>

      <td>
        Enter the link you want to serve to your chatters. The link can be a URL, or it can link to one of your organization's communication methods using the following formats:

        * **Email** – `example@ada.com`
        * **Phone number (with country code)** – `tel:+11234567890`
        * **Phone number (without country code)** – `tel:1234567890`

          (A country code is not required if the dialler is in the same country
          as the phone number.)
        * **SMS** – `sms://1234567890` or `sms://+11234567890`
      </td>
    </tr>

    <tr>
      <td>
        **Link Text**
      </td>

      <td>
        Enter the display text for the link that the chatter can click on.
      </td>
    </tr>

    <tr>
      <td>
        **Alt Title**
      </td>

      <td>
        Enter an alternate title for the link, to give chatters using screen readers some extra context (e.g., `Link to call customer support line`)
      </td>
    </tr>

    <tr>
      <td>
        **Generate Preview**
      </td>

      <td>
        Turn this toggle on to automatically generate a preview of the link in Ada's web chat. If the toggle is off, you can manually create a preview for web chat by entering your own title, icon, and description for the link.
      </td>
    </tr>

    <tr>
      <td>
        **Open in New Tab**
      </td>

      <td>
        Turn this toggle on to have the link open in a new browser tab for the chatter. Otherwise, the link will open in the current browser tab.
      </td>
    </tr>

    <tr>
      <td>
        **Count as Handoff**
      </td>

      <td>
        Turn this toggle on to count clicks on the link as a handoff, so you can track clicks in your handoff reports.
      </td>
    </tr>
  </tbody>
</table>

![](/_fern-files/_img/4f065657f179be253b93ee33f189302dd13367b53c3cabd2061a7ba6bee79239.webp)![](/_fern-files/_img/49b52e10131fb3c28a7fbae1b0a485717e0dbaf1f3af8c3d45ac1fb8709eb9b7.webp)

## Picture Message block\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_7eca9517-e383-4b35-a929-72c7e33b22e5]

A Picture content block allows you to link to an image or upload it
directly from your files. This content block can accommodate JPG, GIF,
SVG or PNG, and includes an alternative text field.

In the chatter view, images will be sized to the chat window, and can be
expanded with a simple click!

![](/_fern-files/_img/b6a5dc5b48a2e9e9383664ca7d80adb70ca5548fdb4a712848c1dc208669147b.webp)![](/_fern-files/_img/6b6d850d87f61e4c3fa2dacf15b6764aaeff90d969bc187990913270a3b3ccd6.webp)

## Video Message block\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_7cb4d674-3abe-4945-a326-494e1085058b]

Like the Picture block, the Video block allows you to link to a video or
upload it directly. You can either upload an MP4 or use a YouTube or
Vimeo link!

Videos will play right in the chatbot window.

> **Note**
>
> * The maximum size for a video upload is 64 MB. If your video file is
>   larger, consider uploading your video to YouTube or Vimeo and
>   providing the link instead.
>
> * Some YouTube videos do not allow embedding. If this is the case, the
>   account owner must adjust the video's settings in YouTube before the
>   video can be embedded in the Answer.

![](/_fern-files/_img/2bbce9afba6ecb73ecf2967fd7a652b3d147f519e326d0a2ce2f6838a2a54b63.webp)![](/_fern-files/_img/d7e0c83ff7835e7214548b0b0a31c26aaf87737b0ad15fcb81f8d53d196f6cd2.webp)

## Web Window block\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_b141406b-2298-4cbc-a474-0fde9dddbe89]

A Web Window is similar to a Link block, except it allows you to
customize the width and height of the corresponding window that opens.

Add the destination URL into the Window URL field, and customize the
message and button text that will be presented to the chatter. Make sure
to include the height and width dimensions of the window (in pixels) to
get full use of this feature!

The Web Window block also has a Count as a Handoff toggle, similar to
the Link block. Toggle this on if you would like to consider all link
clicks for this block as a handoff in your analytics.

![](/_fern-files/_img/8d88640d60bcdf76451a96f079125569ac5105b46bec2aed9674796f9eadacbf.webp)

## Builder Note block\[#UUID-0c4a3fdf-aead-f9a3-31ae-be79e9c09b2c_id_360020139913_id_h_01EQC6AQXEQ1R9DDSY0W50D283]

The Builder Note block lets you add context to Answers and leave notes
for other builders and Bot Managers. Use it to manage longer Answers or
to provide a note on a particular section of an Answer. To use the
Builder Note block, drag it into your Answer, and type in your note.

![](/_fern-files/developers.ada.cx/cab0f8ff0766ab7fb29bd35ffc87b4ca5972e61011b55dc6988046f0468644bc/ada.docs.buildwithfern.com/2025-05-28T19:49:52.708Z/versions/assets/image/uuid-9da388c9-7d6e-0e5e-5b00-cc3a8c5ced75.gif)

---

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