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

# WhatsApp carousel templates: media card rules

> WhatsApp's rules for media card carousels: 2 to 10 cards, card media and text, buttons per card, and how Flowella builds and sends them.

A media card carousel is a marketing template that sends one message bubble followed by 2 to 10 cards the customer scrolls sideways. Each card has its own image or video, optional text and up to 2 buttons. Use carousels to show several products, offers, venues or options in one message. Meta approves the template as a whole, including how many cards it has.

> [!NOTE]
>
> **In Flowella.** Partly supported. Flowella builds, submits and sends media card carousels, from test sends, bulk send, the inbox, HubSpot and the API. It doesn't support product card carousels, which pull products from a Meta commerce catalogue. See [Build a carousel template](https://knowledge.flowella.io/app/templates.md#build-a-carousel-template).

## WhatsApp's rules

| Rule | Detail |
| - | - |
| Category | Marketing only |
| Message body | Required, up to 1,024 characters, with variables |
| Message header, footer and buttons | Not allowed. Each card carries its own media and buttons. |
| Number of cards | 2 to 10, fixed when you create the template. Every send uses exactly that number. |
| Card media | Every card has an image, or every card has a video. You can't mix them. |
| Card text | Optional, up to 160 characters. If one card has text, every card needs text. |
| Card buttons | Up to 2 per card: quick reply, URL or phone number |
| Same structure | Every card has the same parts and the same button types in the same order. Labels, links and numbers can differ. |
| URL buttons | One variable at the end of the URL, up to 2,000 characters in total |

Changing the number of cards on a submitted template sends it back for review.

## How customers see it

* Images and videos are cropped to a wide shape that depends on the device. Use landscape media, or keep the important part in the centre.
* The message bubble appears first, then the cards. The customer swipes to see more.
* A URL button opens the link in the phone's browser, outside WhatsApp. Purchases happen on your website, so WhatsApp sends no order events.
* A quick reply tap comes back to you as a reply, with the button's payload.

## Media card or product card

| | Media card carousel | Product card carousel |
| - | - | - |
| Content | Your own images or videos, text and buttons | Products from your Meta commerce catalogue |
| Where the purchase happens | Your website, through a URL button | Inside WhatsApp, through the catalogue |
| In Flowella | Supported | Not available |

## Sending from Flowella

| Channel | Card media and values |
| - | - |
| Test send, bulk send, inbox and HubSpot | Each card's approved sample media, with the values set on the card |
| Flowella API | Optional per-card media, card text variables and button values, with `carouselCards`. One request uses the same cards for every recipient. |

The message body's variables can still differ per recipient on every channel. For the API request, see [Send a carousel](https://knowledge.flowella.io/app/templates.md#send-a-carousel).

## Common rejection reasons

* **A card that isn't marketing-appropriate**, or content that breaks the Commerce Policy on one card. Meta rejects the whole template.
* **Missing samples** for card text variables or URL variables.
* **Cards that don't match**, such as a different number of buttons on one card. Flowella checks this before you submit.

## Related

> [card] [Build a carousel template](https://knowledge.flowella.io/app/templates.md#build-a-carousel-template)
>
> Step-by-step in Flowella.

> [card] [Marketing templates](https://knowledge.flowella.io/whatsapp/templates/marketing-templates.md)
>
> Rules for every marketing send.

> [card] [Media specs](https://knowledge.flowella.io/whatsapp/messaging/media-specs.md)
>
> Image and video formats and sizes.

> [card] [Template review](https://knowledge.flowella.io/whatsapp/templates/template-review.md)
>
> Why templates are rejected.

Checked against Meta's documentation on 18 November 2026: [Media card carousel templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/media-card-carousel-templates) and [Marketing templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.