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

# actions

> Up to ten follow-up choices the end user can tap, rendered as buttons, quick replies, or a list

`actions` lists things the end user might say next. Tapping one sends its label back to the agent as the next message, so every entry must be something the agent can handle. The platform teaches this block on every text channel; see [Response formatting](/channels/formatting/overview).

*Verified against lua-cli 3.33.0.*

## Syntax

```text theme={null}
::: actions
- First choice
- Second choice
:::
```

## Fields

| Field                  | Required     | Notes                                                                     |
| ---------------------- | ------------ | ------------------------------------------------------------------------- |
| `- Label` or `* Label` | Yes, 1 to 10 | One per line; duplicate labels are removed. Short verb phrases work best. |

## Example

```text theme={null}
::: actions
- Add to cart
- Compare with the Student Laptop
- Check store availability
:::
```

<Frame caption="actions rendered as chips in the web widget">
  <img src="https://mintcdn.com/luaglobal/5airD3u2P6mv3Ovl/images/formatting/actions-buttons.png?fit=max&auto=format&n=5airD3u2P6mv3Ovl&q=85&s=49d7585dd9cfbb21ba29036374efd642" alt="Action buttons rendered in the web widget" width="698" height="994" data-path="images/formatting/actions-buttons.png" />
</Frame>

## Where it renders

| Channel                                      | Behavior                                                                                                                                             |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Web widget                                   | Chips at the end of the conversation                                                                                                                 |
| WhatsApp                                     | 1 or 2 entries as reply buttons; 3 or more as an interactive list whose rows are **Option 1**, **Option 2**, … with the entry as the row description |
| Messenger, Instagram                         | Quick replies under **Select an option**                                                                                                             |
| Slack                                        | Buttons; dropped when the reply also has a `payment` block, which renders its own **Pay Now** button                                                 |
| Teams                                        | Buttons; dropped when the reply also has `list-item` cards or a `payment` block                                                                      |
| RCS                                          | Reply suggestions cut at 25 characters, up to 11 shared with `links`                                                                                 |
| MessageBird                                  | Up to 3 buttons, otherwise a numbered text list; dropped with `list-item`                                                                            |
| iMessage                                     | Numbered text list                                                                                                                                   |
| Email (generated inbox and your own address) | Dropped; write the choices into the text instead                                                                                                     |
| SMS, Front                                   | Raw text                                                                                                                                             |

On WhatsApp a row description is cut at 71 characters, and a tapped row reaches the agent as `I selected: *Option 2* (entry)` rather than the bare entry.

## See also

* [Response formatting](/channels/formatting/overview) — the per-channel matrix
* [list-item](/channels/formatting/list-item) — the options an `actions` block usually follows
* [links](/channels/formatting/links) — for choices that open a URL