Skip to main content
Message templates are pre-approved message formats required by Meta for business-initiated conversations on WhatsApp. You must have approved templates before you can send outbound messages to customers.

What are Message Templates?

Message templates are structured messages that:
  • Must be submitted to Meta for approval before use
  • Allow you to start conversations with customers
  • Can include variables for personalization
  • Are required for messaging outside the 24-hour window
Why Templates? — WhatsApp requires templates to prevent spam and ensure businesses send valuable, relevant messages to customers. All business-initiated messages must use approved templates.

When Do You Need Templates?

Template Categories

Templates are organized into categories that determine their approval requirements and use cases:

Utility Templates

Transactional and service-related messages. Use for:
  • Order confirmations
  • Shipping updates
  • Appointment reminders
  • Account notifications
  • Payment receipts
Approval: Usually approved within minutes

Marketing Templates

Promotional and sales-related messages. Use for:
  • Promotional offers
  • Product announcements
  • Newsletters
  • Sales campaigns
  • Re-engagement messages
Approval: May take longer, stricter review
No Cross-Category Content — Do not include promotional content in Utility templates. Meta will reject templates with mismatched category and content.

Authentication Templates

Verification and security messages. Use for:
  • One-time passwords (OTP)
  • Verification codes
  • Login confirmations
  • Security alerts
Approval: Standard review

Voice Call Request Templates

Special templates to request permission for WhatsApp voice calls. Enabling calling on a sender can create one for you. Use for:
  • Asking a customer for permission to call them on WhatsApp
  • Must be sent inside an open 24-hour chat (they messaged you first)
Approval: Automatic (when using the standard format)
WhatsApp will not deliver this template to a brand-new number. Send a regular template first, wait for their reply, then ask to call. Full flow: WhatsApp Calling.

Creating a Template

Step 1: Navigate to Templates

  1. Go to WhatsApp Senders → Select your sender → Templates tab
  2. Or go to WhatsApp Templates directly
  3. Click Create Template

Step 2: Configure Basic Settings

Naming Best Practices:
  • Use descriptive names: appointment_reminder, order_shipped
  • Include version numbers: welcome_message_v2
  • Avoid generic names: template1, test

Step 3: Write Template Content

Templates can include multiple components:

Header (Optional)

  • Text: Short headline, up to 60 characters, with at most one variable
  • Image: JPG or PNG, up to 5 MB
  • Video: MP4, up to 16 MB
  • PDF: up to 16 MB
You upload the file once, in the template builder. It is sent with every message of the template, from campaigns, the inbox, automations and the API alike.
Only PDF documents can be a template header. Word, Excel and other files can be sent as regular messages while the customer’s 24-hour window is open.

Body (Required)

The main message content. This is where you write your message. Using Variables: Use {{1}}, {{2}}, etc. for dynamic content. Number them once across the whole template, in the order they appear and without gaps: if the header uses {{1}}, the body continues with {{2}}, and a link or coupon code takes the next number. The body can’t start or end with a variable.
Sample Values — When creating templates, you must provide sample values for each variable. These help Meta understand your template’s purpose and are required for approval.
A short line at the bottom (up to 60 characters). Often used for opt-out info or disclaimers.

Buttons (Optional)

Add up to 10 buttons to your template:
  • Quick Reply (up to 10): Pre-defined responses such as “Yes” or “Not now”. The customer’s tap comes back to the conversation.
  • Link (up to 2): Opens a web page. To send a different link per message, end it with a slash and a variable, for example https://example.com/order/{{3}}.
  • Phone Number (1): Starts a phone call to the number you enter, with the country code.
  • Coupon Code (1, Marketing templates only): Lets the customer copy a code. Enter a fixed code of up to 15 characters, or a variable such as {{4}} for a different code per message.
  • WhatsApp Call (1): Lets the customer call you on WhatsApp. Available on senders with WhatsApp calling turned on, and not together with a Phone Number button.
Keep quick replies together, before or after the other buttons. With more than three buttons, WhatsApp shows two and puts the rest under “See all options”. Templates with four or more buttons, or quick replies mixed with other buttons, aren’t shown on WhatsApp Desktop. The Voice Call Request category has its own button, which asks the customer for permission to call them.

Step 4: Submit for Approval

  1. Review your template content
  2. Click Submit for Approval
  3. Template status changes to “Pending Approval”
  4. Wait for Meta review (minutes to 24 hours)

Template Approval Process

Approval Times

Template Statuses

Common Rejection Reasons

Avoid these common mistakes to improve your approval rate:

❌ Promotional Content in Utility Templates

Problem: Including discounts, offers, or marketing language in Utility templates. Solution: Use Marketing category for promotional content.

❌ Missing or Unclear Variable Samples

Problem: Variables like {{1}} without clear sample values. Solution: Provide realistic sample values that show the variable’s purpose:
  • ✅ {{1}} = “John Smith”
  • ✅ {{2}} = “#12345”
  • ❌ {{1}} = “test”

❌ Aggressive or Threatening Language

Problem: Content that could be perceived as harassment, threats, or spam. Solution: Use professional, friendly language. Focus on value to the customer.

❌ URL Shorteners

Problem: Using bit.ly, tinyurl, or other URL shorteners. Solution: Use full, branded URLs from your domain.

❌ Incorrect Category Selection

Problem: Choosing the wrong category for your content type. Solution: Match category to content purpose strictly.

❌ Restricted Content

Problem: Templates about alcohol, gambling, adult content, political messaging, or illegal activities. Solution: These are not allowed. Review Meta’s commerce policies.

Using Templates

Sending Template Messages

Once approved, you can send template messages:
  1. Via Automation Platform: Use the “Send WhatsApp Template” action
  2. Via API: Call the send endpoint with template ID and variables

Variable Replacement

When sending, replace variables with actual values: Template:
Sent Message:

Best Practices

1. Use Descriptive Names

2. Keep Messages Concise

WhatsApp users expect quick, clear messages. Get to the point and include a clear call-to-action.

3. Use Interactive Buttons

Add Quick Reply or Call-to-Action buttons to make it easy for customers to respond:
  • “Track Order”
  • “Contact Support”
  • “View Details”
  • “Confirm Appointment”

4. Test Before Bulk Sending

Always test your template with a single recipient before sending to a large audience. This helps catch formatting issues.

5. Create Templates Early

Approval can take up to 24 hours. Create and submit templates before you need them.

6. Have Backup Templates

Create multiple versions of important templates. If one is rejected or disabled, you have alternatives ready.

Editing Templates

Limited Editing — A template’s content is sent to WhatsApp when you save it, and WhatsApp reviews exactly that version. After that, the content can’t change. To make changes, create a new template with a different name.
This applies to approved, pending and rejected templates. If a template was saved but couldn’t be sent to WhatsApp, you can still edit it and submit it again.

Template Limits

Meta enforces limits on template creation:
  • Maximum templates per WhatsApp Business Account: Varies by account tier
  • Template names must be unique per sender
  • Rejected templates count toward your limit

Next Steps