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

# WhatsApp template rules: names, variables and limits

> The rules every WhatsApp template follows: names, languages, numbered and named variables, statuses, how many templates you can have, and time-to-live.

A WhatsApp template is a message Meta has approved in advance. Templates are the only messages you can send to someone outside the [24-hour customer service window](https://knowledge.flowella.io/whatsapp/messaging/customer-service-window.md), so every campaign, reminder and first contact uses one. Each template belongs to one WhatsApp Business Account, has one category and one language, and must be **Approved** before you can send it.

> [!NOTE]
>
> **In Flowella.** Supported. You build templates in the [template editor](https://knowledge.flowella.io/app/templates.md), or start from Meta's library or a Flowella starter. Flowella submits them to Meta, shows Meta's status, and sends approved templates from the inbox, bulk send, HubSpot workflows and the API. Templates you build in WhatsApp Manager appear in Flowella too, because the templates list reads them from Meta.

## What a template is made of

| Part | Required | Limit |
| - | - | - |
| **Header** | No | Text (60 characters, one variable), image, video, document or location |
| **Body** | Yes | 1,024 characters, with variables |
| **Footer** | No | 60 characters |
| **Buttons** | No | Up to 10 in total, with limits per button type |

Some marketing templates add their own parts, such as carousel cards or an offer countdown. For each part's detail and the limits Flowella's editor applies, see the [Template reference](https://knowledge.flowella.io/app/template-reference.md). For media files, see [Media specs](https://knowledge.flowella.io/whatsapp/messaging/media-specs.md).

## Names

* Use lowercase letters, numbers and underscores only, for example `order_shipped_v2`. Meta allows up to 512 characters.
* Names don't have to be unique. You can give templates in different languages the same name, which is how you offer one message in several languages.
* The same name in the **same** language is refused. Meta returns error 2388024, which Flowella shows as **Content in This Language Already Exists**. Edit the existing template instead, or choose a new name.
* After you delete an approved template, you can't reuse its name for 30 days. See [Template housekeeping](https://knowledge.flowella.io/whatsapp/templates/template-housekeeping.md#delete-a-template).

## Languages

Every template has one [language code](https://knowledge.flowella.io/whatsapp/templates/supported-languages.md), such as `en_GB` or `pt_BR`. Meta doesn't translate anything: you write the text and the sample values in that language. Each language version is a separate template, reviewed on its own and counted separately towards your limit.

## Variables

Variables are placeholders that you fill in when you send, such as a name or an order number. Meta supports two formats:

| Format | Looks like | Rules |
| - | - | - |
| **Positional** (numbered) | `{{1}}`, `{{2}}` | Numbers start at 1 and run in order. Values are sent in the same order. Meta's default. |
| **Named** | `{{first_name}}`, `{{order_number}}` | Lowercase letters and underscores, each name used once. Values are sent by name, in any order. |

A template uses one format throughout. Every variable needs a sample value when you submit, so the reviewer can see a realistic message. A body can't start or end with a variable, and too many variables for the length of the text gets the template refused. See [Template review](https://knowledge.flowella.io/whatsapp/templates/template-review.md#common-rejection-reasons).

> [!NOTE]
>
> **In Flowella.** The editor creates positional variables and asks for a **Fallback value** for each, which Meta reviews as the sample. Flowella can also send templates that use named variables, such as ones built in WhatsApp Manager. See [Template variables](https://knowledge.flowella.io/app/template-variables.md).

## Statuses

Meta reviews every new or edited template, usually within minutes and always within 24 hours. The status then changes over the template's life.

| Meta status | What it means | Shown in Flowella as |
| - | - | - |
| In review (`PENDING`) | Meta is reviewing it | **Pending** |
| Approved (`APPROVED`) | Ready to send. WhatsApp Manager adds a quality label, such as **Active - Quality pending**. | **Approved** |
| Rejected (`REJECTED`) | Meta refused it | **Rejected** |
| Paused (`PAUSED`) | Stopped for now, after poor feedback or low read rates | **Paused** |
| Disabled (`DISABLED`) | Stopped after repeated poor feedback | **Disabled** |
| Appeal requested, archived, pending deletion, deleted, flagged, locked or over the limit | Not sendable | **Disabled** |

Templates saved in Flowella but not yet published show as **Draft**. Meta knows nothing about them until you publish. For pausing, see [Template pacing and pausing](https://knowledge.flowella.io/whatsapp/limits/template-pacing-and-pausing.md). For the editor's status actions, see [Template statuses](https://knowledge.flowella.io/app/template-reference.md#template-statuses).

## How many templates you can have

| Your business portfolio | Templates per WhatsApp Business Account |
| - | - |
| Not verified | 250 |
| [Verified](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md), and at least one number has an approved [display name](https://knowledge.flowella.io/whatsapp/accounts/display-names.md) | 6,000 |

Each language version counts as one template. You can also create no more than 100 templates in one WhatsApp Business Account in an hour.

When you reach the limit, Meta refuses new templates with error 2388019. Flowella's message for this error mentions 250, the limit for unverified portfolios. To make room, delete templates you no longer use, or verify your business to raise the limit. See [Template housekeeping](https://knowledge.flowella.io/whatsapp/templates/template-housekeeping.md).

## Other limits on sending

Approval doesn't mean every send is delivered. These limits apply on top:

* [Messaging limits](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md): how many people you can start conversations with in 24 hours.
* [Template pacing and pausing](https://knowledge.flowella.io/whatsapp/limits/template-pacing-and-pausing.md): Meta holds or stops templates that get poor feedback.
* [Per-user marketing limit](https://knowledge.flowella.io/whatsapp/limits/per-user-marketing-limit.md): WhatsApp limits how many marketing templates each person receives.
* [Archival](https://knowledge.flowella.io/whatsapp/templates/template-housekeeping.md#archival): templates unused for 12 months are archived, then deleted.

## Time-to-live

If WhatsApp can't deliver a template, for example because the phone is off, it keeps trying for a period called the time-to-live (TTL). After that it drops the message, and you get no delivered status.

| Category | Meta's default | Range Meta allows |
| - | - | - |
| Authentication | 10 minutes (30 days for templates created before 23 October 2024) | 30 seconds to 15 minutes |
| Utility | 30 days | 30 seconds to 12 hours |
| Marketing | 30 days | 12 hours to 30 days, through the Marketing Messages API only |

> [!NOTE]
>
> **In Flowella.** Flowella has no TTL setting, so your templates use Meta's defaults. If Meta changes a template's category, it clears any custom TTL set in WhatsApp Manager.

## Delivery order

When you send several messages to one person in a row, WhatsApp doesn't guarantee they arrive in the order you sent them. If order matters, wait for the first message's **delivered** status before sending the next. See [Message statuses](https://knowledge.flowella.io/whatsapp/messaging/message-statuses.md).

## Related

> [card] [Template categories](https://knowledge.flowella.io/whatsapp/templates/template-categories.md)
>
> Marketing, utility or authentication, and when Meta changes it.

> [card] [Template review](https://knowledge.flowella.io/whatsapp/templates/template-review.md)
>
> Why templates are rejected and how to appeal.

> [card] [Templates in Flowella](https://knowledge.flowella.io/app/templates.md)
>
> Build, test and manage templates.

> [card] [WhatsApp pricing](https://knowledge.flowella.io/whatsapp/pricing/whatsapp-pricing.md)
>
> What each category costs.

Checked against Meta's documentation on 18 November 2026: [Template fundamentals](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview), [Template management](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management) and [Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


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