Summary
Creating WhatsApp message templates requires following specific formatting rules so they get approved quickly. This guide explains the naming conventions, content formatting, variable rules, and translation requirements for message templates. Following these guidelines will help streamline the approval process and improve message management.
Important: Meta marketing template character limit
Meta previously introduced a rule that restricted marketing templates to a maximum of 550 characters or 10 emojis. If a template exceeded these limits, message delivery failed with error code
2388040.
This rule has since been rolled back. Marketing templates once again support up to 1024 characters, and the earlier 550-character limit no longer applies.
Instructions
WhatsApp template message guidelines
WhatsApp enforces rules for message templates to keep business messaging high-quality and effective. Here's what you need to know.
1. Key template rules
Parameter (variable) limits — Templates can't have too many placeholders (variables) compared to the length of the message.
❌ Too many variables: Hello {{1}}, your order {{2}} for {{3}} has been shipped to {{4}}. Track it here: {{5}}
✅ Correct usage: Hello {{1}}, your order {{2}} has been shipped. Track it here: {{3}}
Parameter placement — A template can't start or end with a variable.
❌ Invalid: {{1}}, your appointment is confirmed.
✅ Valid: Hi {{1}}, your appointment is confirmed.
Note: Since October 1, 2025, templates that don't follow these rules are blocked at creation. Before that date, such templates could be created but were then immediately rejected. Now, you'll receive a clear error message at the point of creation explaining why, so you can fix the template before resubmitting it.
2. Template category misuse
Using Marketing or Utility templates for identity verification (instead of Authentication templates) may face stricter enforcement.
If misuse is detected, WhatsApp can impose a 7-day restriction, during which you can't create new Utility templates. Persistent misuse can lead to a longer 30-day restriction.
Tip: Always check that your templates are in the correct category and follow WhatsApp's variable rules to avoid rejections.
3. Understanding variables (parameters)
Variables (also called parameters) are placeholders in your template that get filled in with each contact's real values when the message is sent — for example, a customer's name or an order number.
In Wati, you can use either format below — both are supported, and both do the same job: they pull the right value for each contact when the message is sent.
Numbered variables — written as
{{1}},{{2}},{{3}}.Named variables — written with a name, such as
{{customer_name}}or{{order_number}}.
You can choose whichever style you prefer.
Throughout this guide, {{1}} and {{name}} are shown only as examples to illustrate the rules. Use whichever variable style suits your template.
4. Template naming rules
When naming your WhatsApp message template, follow these guidelines:
Use only lowercase alphanumeric characters and underscores (
_).Avoid spaces, capital letters, and special characters other than underscores.
Choose a descriptive name so both WhatsApp reviewers and your team can manage templates easily.
The template name can be up to 512 characters long.
Correct template names:
✅ shipping_update
✅ order_followup1
✅ payment_reminder
Incorrect template names:
❌ ShippingUpdate (uses capital letters)
❌ order follow-up (contains a space and a hyphen)
❌ message_124a! (contains a special character other than underscore)
Tip: A clear, meaningful name speeds up approval. Avoid random or unclear names like message_124a.
5. Template content rules
To ensure your template is formatted correctly and gets approved, follow these content guidelines:
Content must be text-based (letters, digits, special characters, emojis, and WhatsApp-specific formatting).
Maximum length: 1024 characters for Marketing, Utility, and Authentication templates.
For Authentication templates, the message body can only use the preset provided by Meta. You can still add more instructions in the template footer.
Content cannot include:
New lines or tab spaces.
More than four consecutive spaces.
Use double curly brackets (
{{ }}) for variables — for example,{{1}}or{{customer_name}}.A WhatsApp Business Account can create up to 100 message templates per hour.
Correct template content (numbered variables):
Hello {{1}}, your order {{2}} has been shipped
and is expected to arrive by {{3}}.Correct template content (named variables):
Hello {{name}}, your order {{order_number}} has been shipped
and is expected to arrive by {{delivery_date}}.Incorrect template content:
Hello {{ name }}, your order {{ order_number }} has been shipped
and is expected to arrive by {{ delivery_date }}.❌ Extra spaces, spaces inside the curly brackets, and unnecessary new lines.
6. Template translations
You can send message templates in multiple languages, but WhatsApp does not provide automatic translations. To send messages in different languages, submit each translated version separately.
Translations must follow the same formatting rules as the original template.
Keep the placeholders (
{{1}}or{{variable_name}}) consistent across all translations.
Following these guidelines will help you create WhatsApp message templates that meet WhatsApp's approval requirements and ensure smooth communication with your customers. If you run into issues, re-check your template's formatting and naming before resubmitting.
Frequently Asked Questions (FAQs)
Template Rules
1. What are the variable rules for WhatsApp message templates?
WhatsApp message templates cannot contain too many variables compared with the length of the message. A template also cannot start or end with a variable. For example, {{1}}, your appointment is confirmed. is invalid, while Hi {{1}}, your appointment is confirmed. is valid.
Since October 1, 2025, templates that violate these variable rules are blocked at creation, with an error message explaining the issue.
2. What happens if Marketing or Utility templates are misused for identity verification?
Using Marketing or Utility templates for identity verification instead of Authentication templates may result in stricter enforcement. WhatsApp can impose a 7-day restriction during which new Utility templates cannot be created. Persistent misuse can result in a longer 30-day restriction.
Template Variables and Content
3. What variable formats are supported in Wati?
Wati supports both numbered and named variables. Numbered variables use formats such as {{1}}, {{2}}, and {{3}}, while named variables use formats such as {{customer_name}} and {{order_number}}. Both formats perform the same function.
Variables must use double curly brackets, and spaces should not be placed inside the curly brackets.
4. What are the content rules for WhatsApp message templates?
WhatsApp message template content can contain text, letters, digits, special characters, emojis, and WhatsApp-specific formatting. Content can be up to 1024 characters for Marketing, Utility, and Authentication templates.
Templates cannot contain new lines, tab spaces, or more than four consecutive spaces. A WhatsApp Business Account can create up to 100 message templates per hour.
For Authentication templates, the message body can only use the preset content provided by Meta, although additional instructions can be added in the footer.
Template Naming
5. What are the naming rules for WhatsApp message templates?
Template names can contain only lowercase alphanumeric characters and underscores (_). Spaces, capital letters, and other special characters are not allowed. Template names can be up to 512 characters long.
Template names should also be descriptive and meaningful so WhatsApp reviewers and your team can easily understand and manage them.
Template Translations
6. Does WhatsApp automatically translate message templates?
No. WhatsApp does not automatically translate message templates. Each translated version must be submitted separately.
Translated templates must follow the same formatting rules as the original template, and placeholders such as {{1}} or {{variable_name}} must remain consistent across translations.
Marketing Template Character Limit
7. What is the current character limit for WhatsApp Marketing templates?
WhatsApp Marketing templates support up to 1024 characters. The previously introduced 550-character limit for Marketing templates has been rolled back and no longer applies.

