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

# images

> Several images as a gallery, a carousel, a collage, or attachments

`images` sends more than one picture at once: product angles, rooms, before and after. The platform teaches this block on every text channel and tells the model to use it, not a bare `::: image`, whenever it shows pictures; see [Response formatting](/channels/formatting/overview).

*Verified against lua-cli 3.33.0.*

## Syntax

```text theme={null}
::: images
![image](https://cdn.example.com/one.jpg)
![image](https://cdn.example.com/two.jpg)
:::
```

## Fields

| Field           | Required         | Notes                                                    |
| --------------- | ---------------- | -------------------------------------------------------- |
| `![image](url)` | Yes, one or more | Public HTTPS URL; the channel fetches the image from it. |

## Example

```text theme={null}
::: images
![image](https://cdn.example.com/product-front.jpg)
![image](https://cdn.example.com/product-side.jpg)
![image](https://cdn.example.com/product-back.jpg)
:::
```

<Frame caption="images rendered as a carousel in the web widget">
  <img src="https://mintcdn.com/luaglobal/5airD3u2P6mv3Ovl/images/formatting/images-gallery.png?fit=max&auto=format&n=5airD3u2P6mv3Ovl&q=85&s=fc3fae36e9865fd42e6e6611719db781" alt="Image gallery rendered in the web widget" width="2538" height="1146" data-path="images/formatting/images-gallery.png" />
</Frame>

## Where it renders

| Channel                                    | Behavior                                                                                                |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| Web widget                                 | Image carousel                                                                                          |
| WhatsApp                                   | One collage image with the reply text as its caption; ignored when the reply also has `list-item` cards |
| Messenger, Instagram, Teams, RCS, iMessage | One image message or attachment per URL                                                                 |
| Slack                                      | First image only                                                                                        |
| MessageBird                                | First three images                                                                                      |
| Email (your own address)                   | Three-column gallery                                                                                    |
| Email (generated inbox)                    | Attachments                                                                                             |
| SMS, Front                                 | Raw text                                                                                                |

A bare `![alt](url)` outside any block is also sent as an image on the messaging channels.

## See also

* [Response formatting](/channels/formatting/overview) — the per-channel matrix
* [list-item](/channels/formatting/list-item) — an image with a title and description
* [documents](/channels/formatting/documents) — files rather than pictures