---
schema_version: "1"
id: f684e4c9220a028865b5657f0c90489a785fb10b68c9211f1c0b3fe263d307cf
title: WhatsApp Carousel Template Reference
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/messaging_whatsapp_carousel_template_reference.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.messaging_whatsapp_carousel_template_reference.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 66c3fc90c3b13460eed865881c74e5ce7228a7f372b89da158ec7da1f6337256
description: Review Meta specifications, agent and bot behavior, analytics, and considerations for WhatsApp carousel templates.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# WhatsApp Carousel Template Reference

Review Meta specifications, agent and bot behavior, analytics, and considerations for WhatsApp carousel templates.

## Meta-Defined Specifications

Carousel templates must comply with Meta's specifications:

  
| Field | Required | Constraints |
| --- | --- | --- |
| MESSAGE\_BODY\_TEXT | Yes | Max 1024 characters. Supports variables. |
| MESSAGE\_BODY\_TEXT\_VARIABLE\_EXAMPLE | If variables used | Must match the number of variable placeholders. |
| TEMPLATE\_LANGUAGE | Yes | Language and locale code. |
| TEMPLATE\_NAME | Yes | Max 512 characters. |
| URL\_BUTTON\_LABEL\_TEXT | If using URL button | Max 25 characters. |
| URL\_BUTTON\_URL | If using URL button | Max 2000 characters. Supports 1 variable appended to end. |
| CARD\_HEADER\_ASSET\_HANDLE | Yes | Uploaded media asset handle via Resumable Upload API. |
| CARD\_HEADER\_FORMAT | Yes | Image or video. |
| PHONE\_NUMBER | If using phone button | Max 20 characters. Alphanumeric. |
| PHONE\_NUMBER\_BUTTON\_LABEL\_TEXT | If using phone button | Max 25 characters. |
| QUICK\_REPLY\_BUTTON\_LABEL\_TEXT | If using quick reply | Max 25 characters. |

## Agent and Bot Experience

- Agents see carousel templates in the template selection wizard and can send them during messaging conversations.
- In the conversation window, agents see a preview of the carousel cards.
- Bots and Agentforce Service Agent send carousel templates through flows by selecting an approved template in the Send Conversation Messages flow action.

## Analytics

Carousel templates capture the following engagement data:

- Template name and button name for interactive actions (click/tap)
- Time and date of delivery
- Read receipt

## Considerations

- Carousel templates are available for the marketing template category only.
- All cards in a carousel must have the same component structure. If any card includes body text, all cards must include body text.
- Carousels require a minimum of 2 and maximum of 10 cards.
- Carousels can't be created in the WABA interface. Use the Salesforce component builder.
- For product card carousels, the Meta catalog must be set up and linked before creating the template.
- Templates must be approved by Meta before use.
- The component renders in the customer's preferred language based on the Messaging End User Language.