WhatsApp Templates
What it is
WhatsApp templates are structured message formats that Meta requires for all business-initiated conversations on the WhatsApp platform. Unlike SMS or email, where you can send messages freely once you have the recipient's contact information, WhatsApp enforces a strict template-based system. Every message your business sends outside of an active 24-hour conversation window must use an approved template. This policy exists to protect users from spam and ensure that businesses communicate clearly and transparently.
Each WhatsApp template must be submitted to Meta for review before it can be used. The review process evaluates the template against Meta's commerce, messaging, and content policies. Templates are categorized as Marketing, Utility, or Authentication, and each category has different approval criteria, delivery behavior, and per-message pricing. Understanding these distinctions is essential for managing costs, ensuring deliverability, and maintaining your sending reputation.
Beyond approval, WhatsApp templates are subject to ongoing quality monitoring. Meta tracks how recipients interact with your templates, including whether they block your number or report the message. This feedback is aggregated into a quality rating that directly impacts your ability to send messages. A high-quality rating allows you to scale your sending volume, while a low rating can result in templates being paused or your daily sending limit being reduced.
When to use
- Understanding why a template was rejected: When Meta rejects your template, this page provides a comprehensive breakdown of common rejection reasons and the specific corrections needed. Rather than guessing at what went wrong, consult the rejection reasons table below to identify and fix the exact issue.
- Planning template submissions: The approval process takes 24 to 48 hours on average, but can be longer for first-time submitters or during high-volume periods. Plan your campaign timelines around this by submitting templates 3 to 5 business days before your intended send date.
- Improving template quality rating: If your template quality drops from High to Medium or Low, the best practices in this guide help you diagnose the cause and take corrective action before Meta pauses the template or reduces your sending limits.
- Editing approved templates: Not all changes require resubmission. This page clarifies which modifications you can make to an approved template and which changes trigger a new review cycle.
- Managing per-number sending limits: Your daily sending capacity on WhatsApp is tied to your quality rating and account history. Understanding this relationship helps you plan send volumes and avoid hitting caps during critical campaigns.
The approval process
The approval workflow follows a predictable sequence. After you create a WhatsApp template in BotBat (see Create a Template), you submit it for review. The template enters a "Pending" state and is sent to Meta's automated and human review pipeline. Most templates receive a decision within 24 to 48 hours, though complex or borderline content may take longer. You receive a notification in BotBat when the status changes.
Once reviewed, the template lands in one of three states.
| Status | Meaning | What you can do |
|---|---|---|
| Approved | The template passed review and is ready to use in campaigns and workflows. | Send messages using this template. Monitor its quality rating over time. |
| Rejected | The template did not pass review. A rejection reason is provided. | Read the rejection reason, correct the issue, and resubmit. |
| Pending | The template is still under review by Meta. | Wait for the review to complete. No action is needed. |
There is no limit to the number of templates you can submit, but repeatedly submitting templates that violate policies without making corrections can flag your account for additional scrutiny.
Handling rejections
When a template is rejected, Meta provides a reason code that explains why. Understanding these reasons and knowing how to fix them is critical for efficient template management. The table below covers the most common rejection reasons.
| Rejection reason | What it means | How to fix it |
|---|---|---|
| Abusive or threatening content | The message contains language that could be perceived as coercive, threatening, or manipulative. | Remove any urgent, fear-based, or aggressive phrasing. Use neutral, informative language. |
| Variable-only content | The body consists entirely or almost entirely of variable placeholders with little static text. | Add meaningful static text around the variables so the message structure is clear. |
| Incorrect category | The content does not match the selected category (e.g., promotional content submitted as Utility). | Change the category to match the actual content. Marketing content must use the Marketing category. |
| Missing business context | The message does not clearly identify the sending business or the purpose of the communication. | Include your business name and a clear statement of purpose in the body text. |
| URL shorteners | The template contains shortened URLs (bit.ly, tinyurl, etc.) which Meta considers a phishing risk. | Replace shortened URLs with full, direct URLs to your domain. |
| Duplicate content | A template with substantially similar content already exists in your account. | Modify the content to be meaningfully different, or use the existing template. |
| Prohibited content | The message promotes restricted products or services (alcohol, gambling, etc.) in violation of Meta's policies. | Remove the prohibited content or consult Meta's commerce policy for allowed messaging approaches. |
When resubmitting a corrected template, do not simply make a superficial change and hope it passes. Address the specific rejection reason directly. If the reason is unclear, review Meta's Business Messaging Policy documentation for detailed guidance.
Quality rating and monitoring
Every approved template receives a quality rating based on how recipients react to it. Meta collects signals such as blocks, reports, and low read rates to calculate this rating. The quality rating is displayed on the template detail page and updated regularly.
| Rating | Indicator | Meaning | Recommended action |
|---|---|---|---|
| High | Green | Recipients are engaging positively. Low block and report rates. | Continue current strategy. This template is performing well. |
| Medium | Yellow | Some negative feedback detected. The template is at risk of being paused. | Review your targeting. Consider whether the content is relevant to the audience segment receiving it. |
| Low | Red | Significant negative feedback. Meta may pause this template automatically. | Stop sending with this template immediately. Analyze the content and audience. Consider creating a new, improved template. |
Quality degradation is often caused by poor audience targeting rather than bad content. Sending a marketing template to contacts who never opted in, or blasting a generic message to your entire contact list, generates blocks and reports. Segment your audience carefully and send relevant content to each segment.
Editing approved templates
You can make limited changes to an approved template without triggering a new review cycle. However, structural changes require resubmission and re-approval. The table below clarifies which edits are allowed.
| Field | Editable without resubmission | Notes |
|---|---|---|
| Header media (image, video, document) | Yes | You can swap the media file without resubmission. The new file must meet the same format and size requirements. |
| Body text | No | Any change to the body text requires resubmission and re-approval. |
| Variables | No | Adding, removing, or reordering variables requires resubmission. |
| Buttons | No | Changes to button labels, URLs, or types require resubmission. |
| Footer text | No | Footer modifications require resubmission. |
| Category | No | You cannot change the category of an approved template. Create a new template with the correct category instead. |
If you need to make structural changes, the recommended approach is to create a new template with the desired modifications, submit it for approval, and then retire the old template once the new one is approved.
Message sending limits
WhatsApp imposes per-phone-number daily sending limits that govern how many business-initiated conversations you can start. These limits are tied to your account quality, sending history, and phone number verification status.
| Tier | Daily conversation limit | How to reach this tier |
|---|---|---|
| Tier 1 | 250 conversations | Default for newly registered phone numbers. |
| Tier 2 | 1,000 conversations | Maintain High quality and send at least 250 conversations over 7 days. |
| Tier 3 | 10,000 conversations | Maintain High quality and send at least 1,000 conversations over 7 days. |
| Tier 4 | 100,000 conversations | Maintain High quality and send at least 10,000 conversations over 7 days. |
| Unlimited | No cap | Reserved for verified businesses with a sustained High quality track record. |
Tier upgrades happen automatically when you meet the criteria. However, if your quality rating drops to Low, Meta can reduce your tier, which may disrupt active campaigns. Maintaining a High quality rating is not just about reputation; it directly determines your operational capacity.
Steps
- Submit a template for approval: After creating your WhatsApp template, click "Submit" to send it to Meta for review. The template status changes to "Pending" on your template list.
- Wait for Meta review: Approval typically takes 24 to 48 hours. You receive an in-app notification when the review is complete. Avoid resubmitting the same template while it is still pending.
- Check the approval status: Return to the Templates page and review the status badge. Approved templates display a green badge and are immediately available for use.
- Handle rejections promptly: If rejected, open the template detail page to read the specific rejection reason. Correct the identified issue and resubmit. Do not make unrelated changes, as this can introduce new issues.
- Monitor quality ratings regularly: Check the quality rating on each active template at least weekly. If a rating drops to Medium, investigate immediately. If it drops to Low, stop sending with that template and plan a replacement.
- Plan for sending limits: Before launching a large campaign, verify your current sending tier in the account dashboard. If your tier does not support the planned volume, either phase the campaign over multiple days or work on upgrading your tier first.
Common pitfalls
- Not allowing enough time for approval: Submitting templates the day before a campaign launch leaves no buffer for rejection and resubmission. Always submit at least 3 to 5 business days in advance, especially for initial submissions or templates with complex content.
- Resubmitting without fixing the issue: Repeatedly submitting a rejected template without addressing the stated reason wastes time and can flag your account for additional review. Read the rejection reason carefully and make the specific correction before resubmitting.
- Ignoring quality degradation: A template moving from High to Medium quality is an early warning signal. If you do not adjust your sending strategy by improving targeting, refining content, or reducing volume, the template may be paused by Meta and your sending tier may be downgraded.
- Using marketing templates too aggressively: Sending marketing templates to contacts who have not opted in generates blocks and reports. This degrades your quality rating rapidly. Only send marketing messages to engaged contacts who have explicitly consented to receive promotional communications.
- Overloading with irrelevant buttons: Adding buttons that do not relate to the message content leads to poor user experience and potential rejection. Each button should serve a clear, logical purpose that aligns with the message body.
- Assuming instant approval: Unlike SMS and email templates, WhatsApp templates are never available instantly. Always factor the approval timeline into your planning. If you need a template for a time-sensitive event, submit it well in advance.
Create separate templates for different audience segments rather than relying on one generic template. A targeted message to a well-defined segment generates better engagement and fewer blocks than a broad, one-size-fits-all message. This directly improves your quality rating and protects your sending limits.
- WhatsApp Approval Process
- Handling Rejections
- Quality Rating
- Editing Approved Templates
- Sending Limits
- Template Status