> For the complete documentation index, see [llms.txt](https://help.3sigmacrm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.3sigmacrm.com/whatsapp-business-api/templates.md).

# Templates

WhatsApp **Templates** are messages that WhatsApp has approved in advance. You need an approved template to start a conversation, send a campaign, or message a lead from an automation.

> Templates are available on the **Ultimate** plan and above. Find them under **Marketing → Templates** in the left menu.

***

## The Templates Page 📋

Your templates appear as cards. Each card shows the template name, its status, category, message text, language and the WhatsApp number it belongs to.

| Status          | Meaning                                                       |
| --------------- | ------------------------------------------------------------- |
| 🟢 **Approved** | Ready to use in campaigns, chats and automations              |
| 🟡 **Pending**  | WhatsApp is reviewing it (can take up to 24 hours)            |
| 🔴 **Rejected** | Not approved. The card shows **Why:** with WhatsApp's reason. |
| ⚪ **Paused**    | WhatsApp has paused it, usually because of poor feedback      |

Use the toolbar to **Search templates**, filter by number (**All numbers**, shown when you have more than one), or **Reload templates**.

On each card you can:

* **Copy template**: make a copy, for example to translate it into another language
* **Edit template**: change and resend it for review
* **Delete template**: removes it from WhatsApp too. Campaigns using it will stop.

***

## Creating a Template ✍️

Click **Create template** and choose a type:

* **One message**: text, one image or file, and buttons
* **Carousel**: 2 to 10 swipeable cards, each with its own image or video, text and buttons. Great for showing products.

### Basic details

* **Template name**: small letters, numbers and `_` only (spaces turn into `_` automatically)
* **WhatsApp number**: if you have more than one number, pick the one this template is for. Only campaigns from this number can use it.
* **Category**:
  * **Marketing**: offers and promotions
  * **Utility**: order updates and reminders
  * **Authentication**: OTP codes
* **Language**
* **Let WhatsApp change category**: choose **Yes** for a better chance of approval

### Header (optional)

Choose **None**, **Text**, **Image**, **Video** or **Document**.

* Text header: up to 60 characters and at most 1 lead field
* Image: JPG/PNG up to 5 MB
* Video: MP4/3GP up to 16 MB
* Document: PDF, Word, Excel, PowerPoint or TXT up to 100 MB

### Message

Write the main text (up to 1024 characters). Click **Insert lead field** to add personal details like the customer's name. 3sigma fills these in for each lead when the message is sent, so you don't need to match them up again in your campaign.

### Footer (optional)

A small grey line under the message, for example *"Reply STOP to opt out"* (up to 60 characters).

### Buttons (optional)

Choose **Call to Action** and add buttons:

* **Phone**: lets the customer call you (max 1)
* **URL**: opens a website (max 2)
* **Quick Reply**: a tap-to-reply button. Its text is sent back to you when tapped. Keep quick reply buttons together.

Button text can be up to 25 characters.

### Preview and submit

A live WhatsApp-style preview shows on the right as you type. When you're happy, click **Send for review**. WhatsApp checks every template, which can take up to 24 hours, and you can't edit a template while it's being reviewed.

***

## Template Performance 📊

Open any existing template with **Edit** to see its **Template Performance Funnel**. It covers every campaign that used the template:

* **Sent**: messages successfully sent
* **Delivered**: reached the customer's phone
* **Read**: opened by the customer
* **Replied**: the customer responded

Each stage shows the percentage of sent messages and the drop-off from the stage before it, so you can see where people lose interest.

***

## Templates on the Mobile App 📱

Templates are created and edited on the web app. On the mobile app you can use them:

* **Content** tab → **WP Template** shows your templates (this tab appears once you have templates).
* In **More → Inbox**, open a chat, tap the templates button and pick an approved template to send. You'll see a preview first – tap **Send now** to send it.
* If you open a lead that has no WhatsApp chat yet, the chat shows a **Send template** bar – WhatsApp only lets you start a conversation with an approved template.

***

## Tips for Faster Approval ✅

* Keep the message clear and specific. Avoid ALL CAPS and too many emojis.
* Pick the right category. Offers belong in **Marketing**, not **Utility**.
* Add an opt-out line in the footer for marketing messages.
* If a template is rejected, read the **Why:** reason, fix it and click **Send for review again**.

***

## FAQs 🤔

1. **How long does approval take?**\
   Usually a few minutes, and up to 24 hours.
2. **Why can't I see my template in a campaign?**\
   Only **approved** templates made for the number you picked in **Send from** are shown.
3. **Can I change the category after approval?**\
   No. To use a different category, copy the template and submit the copy.
4. **How do I make the same template in another language?**\
   Click **Copy template** and choose a new language.
5. **Can a bot send a template with lead fields in it?**\
   No. Bots can only send templates without lead fields.

For further assistance, reach out to our support team via the **"More > Help & support"** option in the app! 🌟
