> For the complete documentation index, see [llms.txt](https://docs-latam.messaging.sinch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-latam.messaging.sinch.com/whatsapp/whatsapp-carousel-coming-soon.md).

# WhatsApp Carousel (coming soon!)

## What is the WhatsApp Carousel

The Carousel is a WhatsApp template format that lets you present, in a single message, a text introduction followed by several customizable swipeable cards. Each card combines a media item (image or video), a text and, optionally, buttons.

With it, a campaign can showcase several products, offers or options in one message. The Carousel is created under the "Marketing - Carousel" template category and follows WhatsApp (Meta) rules. Although it is created on our platform as "Marketing - Carousel", this category does not exist at Meta and will appear in reports as Marketing.

### Availability

This type of message is supported only directly via ConvAPI (Sinch API) or through the Messaging platform (MM2), which uses ConvAPI.

### Message structure

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Element</strong></td><td valign="top"><strong>Description</strong></td></tr><tr><td valign="top">Introduction</td><td valign="top">Text displayed before the cards.</td></tr><tr><td valign="top">Cards</td><td valign="top">Each card contains media, body and, optionally, buttons.</td></tr><tr><td valign="top">Buttons</td><td valign="top">On each card (at least one button, maximum 2): quick reply, phone number or website (which can have a dynamic URL).</td></tr></tbody></table>

## How to create a Carousel template

**1 -** Open the WhatsApp template creation and fill in the name, language and category.

**2 -** Choose the category "Marketing - Carousel". Remember: it appears as a category in MM2, but for Meta the template is Marketing.

**3 -** Write the Introduction (up to 1,024 characters, including variables). For this reason, we recommend avoiding very long texts, leaving room for possible variables.

**4 -** Build the cards in the Carousel field. You need at least 2 and at most 10 cards. For each card, define:<br>

* **Media:** choose image or video and upload the file.
* **Body:** card text, up to 160 characters, including variables.
* **Buttons:** up to 2 buttons per card. Choose the type, enter the button text and, for a website button, the URL, which can be static or dynamic.

**5 -** Complete all fields of a card before moving on to the next one. While a required field is pending, the button to proceed is not enabled.

**6 -** Submit the template sample. When you proceed, MM2 opens the sample step. Meta requests a sample of the content that will be sent after approval, and it must cover everything that has a variable or media:

* If the introduction has a variable, provide a sample of the expected content.
* For each card, provide a sample of the variables (body and dynamic URL) and upload the sample media.
* Use the arrows or the indicator dots to navigate between cards.
* Finish the sample and then create the template to submit it.

**7 -** Wait for Meta approval. The template is sent to Meta for review and can only be used for sending after it is approved.

## How to send a message with the template

1. Choose the Carousel template. The template language is pre-filled and cannot be edited.
2. Introduction: the template text comes as default. If it has a variable, choose the matching dynamic field from the list. MM2 shows how many characters the text has, not counting variables.
3. Carousel: edit each card and upload the corresponding image or video.
4. Body of each card: fill in any missing variables
5. Buttons: if a website button has a dynamic URL, fill in the variable field on each card.
6. Complete all fields of a card before moving on to the next one, just as in template creation.
7. Follow the regular MM2 campaign flow: select the campaign, schedule it and send your message!

## Usage rules

### Content limits

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Item</strong></td><td valign="top"><strong>Limit</strong></td><td valign="top"><strong>Notes</strong></td></tr><tr><td valign="top">Introduction</td><td valign="top">Up to 1.024 characters</td><td valign="top">Includes variables</td></tr><tr><td valign="top">Number of cards</td><td valign="top">Minimum 2 and maximum 10</td><td valign="top">—</td></tr><tr><td valign="top">Image</td><td valign="top">Up to 5 MB</td><td valign="top">Formats .jpeg, .jpg and .png</td></tr><tr><td valign="top">Video</td><td valign="top">Up to 16 MB</td><td valign="top">Format .mp4</td></tr><tr><td valign="top">Body of each card</td><td valign="top">Up to 160 characters</td><td valign="top">Includes variables</td></tr><tr><td valign="top">Buttons per card</td><td valign="top">Up to 2</td><td valign="top">Quick reply, phone or website</td></tr><tr><td valign="top">Button text</td><td valign="top">Up to 20 characters</td><td valign="top">—</td></tr><tr><td valign="top">Website button URL</td><td valign="top">Up to 2.000 characters</td><td valign="top">Can be static or dynamic</td></tr></tbody></table>

### Meta rules applied to the Carousel

Unlike the RCS carousel, Meta requires all cards to follow the same pattern. MM2 applies these rules before submitting the template for approval:

* Same media type: if one card has an image, all cards have an image. Mixing image and video is not possible.
* Same button category: if one card has a button, all cards must have buttons of the same category. The content does not need to be the same, but the button type must be.
* Same button order: the sequence of buttons must be identical on all cards. For example, a card with website and phone buttons cannot coexist with another card with phone and website.

### Filling in

* Media and body are required on every card. Buttons are optional.
* You cannot move on to the next card, or complete the step, with pending fields (for example, a card without the button text or without the website button URL). This applies to both creation and sending.
* The body field does not accept more than 160 characters.
