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

# Create WhatsApp message templates

> Create WhatsApp templates, send them to Meta for approval, and use them in cart reminders, order updates and campaigns. Start from ready-made ones.

Every cart reminder, order update and campaign starts with a template: a message Meta has approved, with blanks for things like the customer's name or order number. Create your templates here, send them to Meta for approval, and track them in one place. To open it, go to **Message Templates → WhatsApp**.

Once a template is approved by Meta, it's ready to use in campaigns, automations, and other supported messaging features.

> [!NOTE]
>
> Before you can add a template, you need to [connect a WhatsApp channel](https://docs.chatflows.io/core-setup/channels/whatsapp.md) to your workspace.

## Adding a Template

* **Sync Templates** – If you've already created templates in your **Meta Business account** and that account is connected to your WhatsApp channel, click **Sync Templates** to import them into ChatFlows.
* **Add Template** – Click [**Add Template**](#creating-a-template) to create a new template directly in ChatFlows.

> [!NOTE]
>
> If you have more than one connected channel, clicking **Sync Templates** opens a menu where you can choose **Sync all accounts** or select a specific channel to sync.

## Template Collection

The Template Collection is a set of pre-built templates for common use cases, organized into **Header**, **Carousel**, and **Authentication** tabs.

* **Use Template** – Opens it as an editable draft. Enter a template name, adjust the content as needed, then submit it for approval.
* **Favourite** (star icon) – Saves it under the **My Favourites** tab for quick access.

If none fit, click [**Add Template**](#creating-a-template) to build one from scratch.

![Template Collection dialog with tabs for My Favourites, Header, Carousel, and Authentication, showing pre-built templates such as Flash Sale Announcement and Order Confirmation, each with a category badge, a star icon, and a Use Template button](https://docs.chatflows.io/messaging/img/template-library.png)

Image shows the Template Collection dialog.

## Creating a template

After clicking **Add Template**, choose one of three template types:

* [**Header Template**](#header-template) – For marketing and utility messages like offers, updates, and notifications.
* [**Carousel Template**](#carousel-template) – For displaying multiple products or a catalog in scrollable cards.
* [**Authentication**](#authentication) – For sending OTP codes for user verification.

![Create WhatsApp Template dialog listing three choices: Header Template, Carousel Template, and Authentication, each with a short description](https://docs.chatflows.io/messaging/img/template-pick-type.png)

Image shows the template type picker.

### Header Template

A Header Template allows you to include an image, video, document, or text header in your WhatsApp message, making it ideal for marketing and utility messages.

![Example of a WhatsApp header template message on a phone, with a promotional image header, a greeting body using a variable, and Shop Now and View Offers buttons](https://mintcdn.com/chatflows-docs/9xxtuyzjz9qXCLbF/messaging/img/template-header-example.png?fit=max\&auto=format\&n=9xxtuyzjz9qXCLbF\&q=85\&s=6d4d845383829a4a1ec7a6fd184614a8)

Follow these steps to build one:

**1. Fill in Basic Info**

![Basic Info step of the template builder with fields for Channels, Template Name, Language, and Category, beside a sidebar tracking the five steps](https://docs.chatflows.io/messaging/img/template-basic-info.png)

Image shows the Basic Info step of the template builder.

Enter the basic details for your template:

* **Channels** – Select the connected WhatsApp account that the template belongs to.
* **Template Name** – Enter a unique name using only lowercase letters, numbers, and underscores (for example, `order_confirmation`).
* **Language** – Select the language of your template content. Make sure the message is written in the selected language to avoid template rejection during Meta's review.
* **Category** – Choose the category that best matches the purpose of your message:
  * **Marketing** – Promotional messages such as offers, discounts, product launches, and announcements.
  * **Utility** – Transactional messages such as order updates, delivery updates, account alerts, and payment confirmations.

**2. Build the Header**

![Header step with an Include Header toggle switched on, a Header Type choice of Text, Image, Video, or Document, and a Header Text field limited to 60 characters](https://docs.chatflows.io/messaging/img/template-header.png)

Image shows the Header step of the template builder.

Add an optional header to your message — **Text** (up to 60 characters), **Image**, **Video**, or **Document**.

A text header should be plain text only. Per Meta's rules, header text can't contain emojis.

> [!NOTE]
>
> Supported formats and file size limits are set by Meta. See Meta's [supported media types](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types) for the current limits.

**3. Write the Message Body**

![Body step with a formatting toolbar, a message body containing a variable, and a Detected Variables list below it](https://docs.chatflows.io/messaging/img/template-body.png)

Image shows the Body step of the template builder.

The main message content of your template, up to 1,024 characters. Use the toolbar to format text with **bold**, *italic*, strikethrough, or code.

To insert dynamic values, click **+ Add Variable** to add placeholders like `{{1}}` and `{{2}}`.

Each variable appears in a **Detected Variables** list below the body. ChatFlows assigns each a sample value (like "Value 1") for Meta's review — these aren't sent to customers.

When you send the template, each variable is replaced with real data, such as a [merge field](https://docs.chatflows.io/messaging/merge-fields.md) (the contact's name) or a fixed value.

**4. Add a Footer (optional)**

![Footer step with a Footer Text field and a note explaining the footer appears in small text below the message body](https://docs.chatflows.io/messaging/img/template-footer.png)

Image shows the Footer step of the template builder.

An optional line of fixed text that appears below the message body, up to 60 characters.

Variables are not allowed in the footer.

**5. Add Buttons (optional)**

![Buttons step with an Add Button control and a Button Type dropdown open, offering Quick Reply, Website URL, Phone Number, and Flow (interactive form)](https://docs.chatflows.io/messaging/img/template-buttons.png)

Image shows the Buttons step of the template builder.

Add up to 10 buttons to let customers take action. There are four types:

* **Quick Reply** – A tappable button that lets the customer reply instantly with the button's text, instead of typing.
* **Website URL** – Opens or redirects to a website link.
* **Phone Number** – Starts a call to the number you set.
* **Flow (interactive form)** – Opens a [WhatsApp Form](https://docs.chatflows.io/messaging/whatsapp-forms.md) the customer fills in without leaving the chat. Lists the published forms on the selected account.

> [!WARNING]
>
> A few limits apply:
>
> * Up to **2 URL** buttons.
> * Up to **1 Phone Number** button.
> * When you mix **Quick Reply** with other button types, you can have a maximum of **3 buttons** in total.

### Carousel Template

A Carousel Template lets you showcase multiple products, services, or items using scrollable cards in a single WhatsApp message.

![Example of a WhatsApp carousel message on a phone, showing a sale announcement followed by scrollable product cards, each with an image, a short description, and Buy Now and View More buttons](https://mintcdn.com/chatflows-docs/9xxtuyzjz9qXCLbF/messaging/img/template-carousel-example.png?fit=max\&auto=format\&n=9xxtuyzjz9qXCLbF\&q=85\&s=fdde35bb0ea66e87527e6971658a597c)

Follow these steps to build one:

**1. Fill in Basic Info**

![Basic Info step of the carousel template builder with fields for Channels, Template Name, Language, and Category, a three-step sidebar, and a live carousel preview](https://docs.chatflows.io/messaging/img/template-carousel-basic-info.png)

Image shows the Basic Info step of the carousel template builder.

Enter the channel, name, and language — same as in the [Basic Info step](#basic-info). For carousel templates, the category is fixed to **Marketing**.

**2. Write the Message Body**

![Body step of the carousel template builder with a Message Body field, formatting toolbar, and an Add Variable button, beside a live carousel preview](https://docs.chatflows.io/messaging/img/template-carousel-body.png)

Image shows the Body step of the carousel template builder.

The main message text that appears above the cards, up to 1,024 characters. Formatting and variables work the same as in the [Body step](#body).

**3. Build the Cards**

![Cards step of the carousel template builder showing Card 1 with a Header Type choice of Image or Video, an Upload media area, a Body Text field, and Buttons, beside a live carousel preview](https://docs.chatflows.io/messaging/img/template-carousel-cards.png)

Image shows the Cards step of the carousel template builder.

Add **2–10 cards**. Each card has:

* **Header** – An image or video ([formats and size limits](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types) are set by Meta).
* **Body text** – Up to 160 characters.
* **Buttons** – 1–2 buttons (Quick Reply or URL).

> [!WARNING]
>
> All cards must use the same number of buttons with matching types (for example, all Quick Reply or all URL). ChatFlows checks this before submission and warns you if the cards don't match.

### Authentication

An Authentication Template lets you send one-time passcodes (OTPs) to verify a user's identity.

![Example of a WhatsApp authentication message on a phone, showing a verification code with a security note and a Copy Code button](https://mintcdn.com/chatflows-docs/9xxtuyzjz9qXCLbF/messaging/img/template-auth-example.png?fit=max\&auto=format\&n=9xxtuyzjz9qXCLbF\&q=85\&s=0d9ec572c2fefcb0aeeb914956e2993b)

Follow these steps to build one:

**1. Fill in Basic Info**

![Basic Info step of the authentication template builder with fields for Channels, Template Name, Language, and Category, beside a live preview of an OTP message with a Copy Code button](https://docs.chatflows.io/messaging/img/template-auth-basic-info.png)

Image shows the Basic Info step of the authentication template builder.

Enter the channel, name, and language for your template. For authentication templates, the category is fixed to **Authentication**.

**2. Configure the OTP**

![OTP Config step of the authentication template builder with an OTP Button Type dropdown, Button Text field, Add Security Recommendation toggle, Code Expiry, and Message TTL fields, beside a live OTP preview](https://docs.chatflows.io/messaging/img/template-auth-otp-config.png)

Image shows the OTP Config step of the authentication template builder.

Choose how the user receives and enters the code. There are three **OTP button types**:

* **Copy Code** – The user copies the code and pastes it manually. Works on all devices, including iOS and web.
* **One-Tap Autofill** – The user taps a button and the code is filled in automatically. Android app only.
* **Zero-Tap** – The code is verified automatically, with no user action. Android app only.

Then configure the delivery settings:

* **Button Text** – The label on the OTP button, up to 25 characters.
* **Code Expiry** – How long the code stays valid (1–90 minutes).
* **Message TTL** – How long WhatsApp retries delivery (30–900 seconds).
* **Security recommendation** – Optional toggle that adds a "do not share this code" note.
* **Android Package Name** and **App Signature Hash** – Required for **One-Tap** and **Zero-Tap**.
* **Accept Zero-Tap Terms** – Required only when you choose **Zero-Tap**.

> [!WARNING]
>
> Once a template is submitted, its **name**, **language**, and **category** can no longer be changed. You can still edit the content and resubmit, or delete it and start over.

## Submitting for approval

Once your template is created, submit it to Meta for review. The template first appears as **Pending** while Meta reviews it. When the review is complete, its status updates automatically to **Approved**, **Rejected**, **Paused**, or **Disabled**.

> [!NOTE]
>
> Whenever Meta updates your template's status — approved, rejected, paused, or disabled — ChatFlows notifies you automatically. An on-screen notification appears and it's added to your notifications so you can review it anytime.

## Managing existing templates

![WhatsApp Templates table listing templates with category, type, status, account, language, and last synced date, with a row menu open showing View Stats, Edit, and Delete](https://docs.chatflows.io/messaging/img/templates-list.png)

Image shows the WhatsApp Templates table with a row menu open.

Use the row menu on any template to:

* **View Stats** — open the template's analytics panel to see sent, delivered, read, and clicked figures over a chosen date range.
* **Edit** the template's content and resubmit it. Editing an approved template sends it back to Meta for review — its status returns to **Pending** and it must be approved again before you can use the updated version.
* **Delete** a template.

> [!NOTE]
>
> **View Stats** is available only when analytics is enabled for your WhatsApp Business Account. If analytics is turned off, enable it in **WhatsApp Manager** and try again.

## Common questions

> [accordion] How long does WhatsApp template approval take?
>
> Meta decides, and the time varies from template to template. ChatFlows shows the template as **Pending** until Meta finishes its review, then updates the status and notifies you.
> See Meta's [template rules](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview).

> [accordion] What happens if Meta rejects my WhatsApp template?
>
> ChatFlows marks the template **Rejected** and notifies you. You can edit the content and submit it again, or delete it and start over.
> The name, language and category can't be changed after you submit.

> [accordion] Can I choose whether my WhatsApp template is Marketing or Utility?
>
> You pick a category when you create the template, but Meta makes the final decision on its category. Carousel templates are always Marketing, and Authentication templates are always Authentication.
> Meta explains the categories in its [template overview](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview).

> [accordion] Can I use the WhatsApp templates I already made in Meta?
>
> Yes. Click **Sync Templates** and ChatFlows imports the templates from the Meta Business account connected to your WhatsApp channel.
> If you have more than one channel, you can sync all of them or just one.

> [accordion] Do I need approval again if I edit a WhatsApp template?
>
> Yes. Editing an approved template sends it back to Meta, and its status returns to **Pending**.
> You can use the updated version only after Meta approves it again.

## What's next

> [card] [Campaigns](https://docs.chatflows.io/messaging/campaigns.md)
>
> Use an approved template to broadcast to a list of contacts.

> [card] [Messenger Templates](https://docs.chatflows.io/messaging/messenger-templates.md)
>
> See how Messenger's local, non-Meta-approved presets work instead.


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