# Carousel Templates

## Overview

A **Carousel Template** in WhatsApp Business API is an interactive message format that allows businesses to send multiple cards within a single message. Each card can contain media, text, and action buttons, and users can scroll horizontally through the cards.

Carousel templates are mainly used for:

* Product showcasing
* Marketing campaigns
* Interactive user engagement

#### Advantages of Carousel Templates

* Displays **multiple items in a single message**
* Improves **user engagement and interaction**
* Allows users to **take actions directly** (visit website, call, quick-reply)
* Provides a **rich and structured user experience**

{% hint style="warning" %}
Carousel Templates can only be created under the Marketing category.
{% endhint %}

## Types of Carousel Templates

There are two types of Carousel Templates:

* **Media Carousel Template**
  * Used for marketing content with images or videos
  * Allows custom text and buttons on each card
* **Product Carousel Template**
  * Used to display products directly from a catalog
  * Product details are fetched automatically

<figure><img src="/files/xiwim6Y3HokSXeH0kk1n" alt=""><figcaption></figcaption></figure>

## Limits & Specifications

#### Body Content

* Maximum length: **1024 characters**

#### Number of Cards

* Minimum: **2 cards**
* Maximum: **10 cards**

#### Media Support

* Supported formats:
  * Image
  * Video

{% hint style="info" %}
Mixing image and video in the same carousel is **not allowed**.
{% endhint %}

## Buttons & Supported Types

#### Media Carousel

Supported button types:

* **Quick Reply**
* **Call To Action (CTA)**
  * Visit Website
* **Phone Number**

<figure><img src="/files/riUSm4VEBtJGjjrQlfRO" alt=""><figcaption></figcaption></figure>

#### &#x20;Button Limits per Card

* Maximum **2 Quick Reply buttons or Combinations of Call To Action or Phone Number button**
* combination of **quick reply** and **call to action** and **phone number** also possible

***

#### Product Carousel

* Supports similar button configurations
* Typically used with **product-related actions (e.g., view product)**

## Character Limits

#### Button Text

* Maximum: **20 characters**
* Emojis are **not supported**

#### Media Size Limits

* Image: Up to **5 MB**
* Video: Up to **16 MB**

#### Card Content (Media Carousel Only)

* Each card can include body text
* Maximum: **160 characters** (including emojis)

{% hint style="info" icon="photo-film" %}
**Product Carousel does not support custom card body text**, as product details are fetched from the catalog.
{% endhint %}

## Product Carousel (Catalog-Based)

Product Carousel Templates are designed to display products directly from a **linked WhatsApp Catalog**.

#### Key Points:

* Products are selected from the connected catalog
* Maximum **10 products** can be added
* Product details such as:
  * Image
  * Name
  * Price\
    are automatically populated.

## Approval Process

Once the template is created:

1. Submit it for approval
2. The template will be reviewed by Meta (WhatsApp)
3. Approval may take some time (typically up to **24 hours**)

<figure><img src="/files/7ujZQwtyaK4NuZ0iY3ZE" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="whatsapp" %}
Templates must comply with WhatsApp policies to get approved.
{% endhint %}

## Best Practices

* Use **high-quality images or videos**
* Keep text **short, clear, and meaningful**
* Use strong **Call-To-Action buttons** (e.g., *Buy Now*, *View Product*)
* Maintain **consistency across all cards**
* Avoid overcrowding cards with too much information

#### Why Carousel is Effective

* Allows users to **view multiple products or content in one message**
* Enables **direct interaction** (website visit, call, quick reply)
* Improves **conversion and engagement rates** compared to plain text messages

{% hint style="info" icon="meta" %}
Carousel Templates provide a powerful way to deliver **rich, interactive content**, but they must strictly follow **WhatsApp guidelines and limitations** to ensure approval and proper delivery.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.pickyassist.com/setting-up-guide/connecting-channels/whatsapp-templates/template-types/carousel-templates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
