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

# horizontal-list-item

> Two to ten image cards side by side, as a carousel on WhatsApp and RCS

`horizontal-list-item` is [`list-item`](/channels/formatting/list-item) with a required image, for options that are compared visually. Send at least 2 and at most 10 blocks in a row. 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}
::: horizontal-list-item
![image](https://cdn.example.com/item.jpg)
# Item title
## Subheading
Brief description.
:::
```

## Fields

| Field           | Required | Notes                                                                      |
| --------------- | -------- | -------------------------------------------------------------------------- |
| `![image](url)` | Yes      | Public HTTPS JPEG or PNG; WhatsApp substitutes a placeholder when missing. |
| `# Title`       | Yes      | Unique per reply; `#Title` without the space also parses.                  |
| `## Subheading` | Yes      | Price, date, location, or status.                                          |
| Remaining lines | No       | Description, about 30 words at most.                                       |

## Example

```text theme={null}
::: horizontal-list-item
![image](https://cdn.example.com/standard.jpg)
# Standard Room
## $120 per night · 5 available
Queen bed, city view.
:::

::: horizontal-list-item
![image](https://cdn.example.com/deluxe.jpg)
# Deluxe Suite
## $200 per night · 2 available
King bed, ocean view, private balcony.
:::
```

## Where it renders

| Channel                                            | Behavior                                                                                                                                         |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Web widget                                         | Cards; consecutive blocks render as one group                                                                                                    |
| WhatsApp                                           | Carousel template of 2 to 10 cards with one **Select** button each; card text combines title, subheading, and description, cut at 135 characters |
| RCS                                                | Carousel of the first 10 cards                                                                                                                   |
| Messenger, Instagram                               | Rendered as `list-item` generic templates                                                                                                        |
| iMessage                                           | Text summary plus the image                                                                                                                      |
| Slack, Teams, MessageBird, email (generated inbox) | Dropped                                                                                                                                          |
| Email (your own address), SMS, Front               | Raw text                                                                                                                                         |

On WhatsApp the carousel is a Meta message template that the platform creates on first use and submits for approval; until it is approved, each item is sent as an image message with a **Select** button. More than 10 items are split into further carousels, a trailing single item is sent as an image message, and a reply with only one `horizontal-list-item` is dropped.

## See also

* [Response formatting](/channels/formatting/overview) — the per-channel matrix
* [list-item](/channels/formatting/list-item) — the vertical form, which renders on more channels
* [WhatsApp](/channels/whatsapp) — channel setup