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

# Templates

> Create, submit, sync, and manage the approved WhatsApp message templates used for outbound messaging.

## What is this?

**Templates** is where you create and manage WhatsApp message templates — pre-approved messages with optional variables that you use to start conversations and run [campaigns](https://wabis.mintlify.site/workspace/whatsapp/campaigns.md). Each template is submitted to Meta for review, and only **approved** templates can be sent.

![The Templates page showing the Total Templates, Approved, and Pending tiles above the templates table](https://mintcdn.com/wabis/b8QJIW0SgwumJWX0/images/templates-list.png?fit=max\&auto=format\&n=b8QJIW0SgwumJWX0\&q=85\&s=93f7dd18c19bf9aee3789ae42cae4fe8)

> [!NOTE]
>
> Templates require the `templates:view` permission (and `templates:create` to create them), an active WhatsApp channel, and a plan that includes WhatsApp integration.

## What can I do here?

* See summary tiles: **Total Templates**, **Approved**, and **Pending**
* Search templates and filter by status, or by **All Max Price**, **Has Max Price**, and **No Max Price**
* Read each template's **Category**, **Status**, **Language**, and **Created At**
* Create a template with **Create Template**, including **Carousel** templates with swipeable cards
* Open the **Predefined** template library to preview, customize, and create ready-made templates
* **Sync Templates** to pull the latest approval status from WhatsApp, and **Refresh** to reload the list
* **Edit**, **Duplicate**, or **Delete** a template
* Select several templates and **Delete Selected**
* **Open in Business Manager** to manage a template in Meta

## How to use it

### Understand a template's structure

A template can include:

| Part | Details |
| - | - |
| **Header** (optional) | Text (up to 60 characters), or an image, video, or document |
| **Body** | The main message, up to 1,024 characters, with variables |
| **Footer** (optional) | Up to 60 characters, such as "Reply STOP to unsubscribe" |
| **Buttons** (optional) | Quick replies or call-to-action buttons |
| **Carousel cards** (Marketing only) | 2 to 10 swipeable cards, each with an image or video, optional card text, and buttons |

### Create a template

1. Go to **WhatsApp → Templates** and click **Create Template**.

2. Under **Basic Information**, enter a **Template Name** (lowercase letters, numbers, and underscores only), choose a **Category**, and choose a **Language**.

3. Under **Template Content**, choose the **Media Type**: **Text Only**, **Image**, **Video**, **Document**, or **Carousel** (shown only when the **Category** is **Marketing**), and upload the header media if needed.

   ![The Create Template dialog showing Basic Information and Template Content with the message preview](https://mintcdn.com/wabis/b8QJIW0SgwumJWX0/images/templates-create-content.png?fit=max\&auto=format\&n=b8QJIW0SgwumJWX0\&q=85\&s=ef352c7300c8eb57d0f80d3753dc8b14)

4. Write the **Body**. Add variables as numbered placeholders, for example:

   ```text theme={null}
   Hi {{1}}, welcome to our service! Your account has been created successfully.
   ```

   Then fill in **Sample Values for Body Variables** — Meta needs an example for each variable.

5. Optionally add a **Header** and **Footer**.

6. Under **Action Buttons**, click **Add Button** and choose **Quick Reply**, **Visit website**, **Call phone number**, or (for authentication templates) **OTP Button**.

7. Check the live preview and the **Template Guidelines**, then submit the template for approval. Use **Save as Draft** if you want to finish later.

> [!NOTE]
>
> WhatsApp allows either up to **3 quick replies** or up to **2 call-to-action buttons** (max 1 phone number and 2 URLs). You can't mix the two.

### Create a carousel template

A carousel template is a message with swipeable cards. Carousel templates are **Marketing** only — if you change the category away from Marketing, the media type switches back to a text template.

1. In **Create Template**, set the **Category** to **Marketing** and the **Media Type** to **Carousel**.
2. Write the **Body** — the message text shown above the cards.
3. Under **Carousel cards**, choose the **Card media type** (**Image** or **Video**). All cards use the same type.
4. Under **Buttons on every card**, click **Add button** and choose the button types (**Quick Reply**, **URL Button**, or **Phone Button**). Every card has the same buttons, up to 2 per card.
5. For each card, click **Upload image** or **Upload video**, optionally add **Card text (optional)**, and fill in the button text. If the card text has variables, add a **Sample value for variable** for each. A URL button can end with `{{1}}` so each send can use a different value.
6. Use **Add card** and **Remove card** to have between 2 and 10 cards, then check the preview and submit.

| Rule | Limit |
| - | - |
| Cards | 2 to 10 |
| Image cards | JPEG or PNG, up to 5 MB |
| Video cards | MP4, up to 16 MB |
| Card text | Up to 160 characters, no line breaks; either every card has text or none do |
| Button text | Up to 25 characters |

A carousel template has no header, footer, or template-level buttons. If something is wrong, a **Fix these before submitting** list shows what to change. To send a carousel template, see [Campaigns](https://wabis.mintlify.site/workspace/whatsapp/campaigns.md#send-a-carousel-template).

### Create predefined templates

Click **Predefined** to open the **Predefined template library**. It lets you browse ready-made templates, preview each one, and create only the ones you need — they are submitted to WhatsApp for approval.

1. Pick a group tab: **E-commerce**, **Events tickets & Booking**, **Notes**, or **Business**.
2. Click a template to preview it, and tick the checkbox of each one you want. Use **Select all available** or **Clear selection** for the whole group. Templates that already exist show an **Added** badge and can't be selected again.
3. If a selected template has a link button (such as Track order), check the **Storefront URL**. It is prefilled from your storefront settings and must be a valid https URL.
4. Optionally use **Customize template** to edit the **Header**, **Body**, **Variables** sample values, **Footer**, and **Buttons**, then click **Reset** to undo. Required variables must stay in the body, numbered `{{1}}`, `{{2}}`, … with no gaps. **Event, ticket and note templates have fixed wording and required variables, so they cannot be edited.** Edited templates show an **Edited** badge.
5. Click **Create selected** to submit them. A message tells you how many were submitted.

### Choose a category

| Category | Use it for |
| - | - |
| **Marketing** | Promotions and campaigns |
| **Utility** | Order updates, receipts, and other account or transaction messages |
| **Authentication** | One-time passcodes and verification codes |

Authentication templates are text-only. WhatsApp formats the body automatically, and you can add the security recommendation and a code expiration of 1–90 minutes.

### Media limits

* **Images:** JPEG or PNG, up to 16 MB
* **Videos:** MP4 or 3GPP, up to 16 MB
* **Documents:** PDF, up to 100 MB
* **GIF** files are not supported

### Set a maximum price (optional)

When your channel supports it, you can set a **Max Price** for a template as a bid cap per 1,000 deliveries, using the **Lowest Cost with Bid Cap** strategy. The amount is in your WhatsApp Business Account's billing currency, in its smallest unit (cents for USD, paise for INR).

> [!WARNING]
>
> Meta doesn't allow adding a max price to a template that was already submitted without one. **Duplicate** the template to create a new copy with max price enabled.

### Approval status

After you submit a template, WhatsApp reviews it — usually within about a day. Its status becomes:

* **Approved** — ready to use in campaigns and conversations
* **Pending** — still under review
* **Rejected** — update it and resubmit

Click **Sync Templates** to pull the latest status from WhatsApp.

### Manage templates

1. **Edit** a template to change it and resubmit.
2. **Duplicate** a template to start a new version from an existing one — this is the way to change an approved template.
3. **Delete** a template you no longer need, or select several and click **Delete Selected**.

### Use a template in a campaign

Create a [campaign](https://wabis.mintlify.site/workspace/whatsapp/campaigns.md), choose an approved template, and map its variables to free text or contact custom fields.

## Troubleshooting / Technical Notes

### Template issues

* The template isn't approved yet, or was rejected in Meta review.
* The variable count or formatting is wrong.
* The category or language doesn't match.
* The template is approved in Meta but not yet visible in the app.

Check the status in both Meta and the app, verify placeholder order, and click **Sync Templates** if approval happened recently.

### Message delivery issues

* A message was sent but not delivered, or delivered but not read.
* Template messages fail while session messages still work.
* Media messages fail because of file format or size.
* The recipient's phone number is wrong or badly formatted.

Confirm the channel is active and connected, check whether the message used a template or a session message, and verify phone-number formatting and media limits.

### Common error areas

* Authentication or token issues
* Template restriction errors
* Rate-limit or throughput issues
* Invalid recipient or unsupported destination errors
* Media fetch or upload failures

Check the exact error code together with the delivery status, confirm whether the problem is channel-specific or system-wide, and re-test after a credential refresh or reconnection before escalating.

### Other checks

* **"Media URL is required for image, video, and document templates."** Upload the header media before saving.
* **"Verification code sample is required."** Authentication templates need a sample code.
* **Body must be under 1,024 characters.** Shorten the message.
* **The Carousel option is missing.** Carousel templates are Marketing only — set the **Category** to **Marketing** first.
* **"Create selected" is disabled in the Predefined library.** Select at least one template, fix any edited template (every variable needs a sample value, every button a label), and enter a valid https **Storefront URL** if a selected template has a link button.

## Related docs

* [Campaigns](https://wabis.mintlify.site/workspace/whatsapp/campaigns.md)
* [Storefront settings](https://wabis.mintlify.site/workspace/catalog/settings.md)
* [WhatsApp overview](https://wabis.mintlify.site/workspace/whatsapp/overview.md)
* [Custom Fields](https://wabis.mintlify.site/workspace/contacts/custom-fields.md)


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