WhatsApp Business API
Rejected WhatsApp Templates: How to Fix Them and Get Approved
Rejected WhatsApp templates stall your messaging campaigns. Here is how to identify the errors, correct them, and get approval as quickly as possible.
In this article Why WhatsApp Templates Get Rejected +
Why WhatsApp Templates Get Rejected
When you submit a WhatsApp template through the Business API, Meta puts it through a review process before authorizing its use. This process exists to ensure that messages comply with privacy policies, are not spam, and offer genuine value to end users. A rejected template simply means it did not pass one or more criteria in that review.
The causes of rejection often fall into specific categories: promotional content not allowed under the chosen template category, ambiguous or misleading language, incorrectly used placeholder variables, or violations of WhatsApp's commercial guidelines. Understanding these categories is the first step toward avoiding recurring mistakes and speeding up the approval process.
One important thing to keep in mind: Meta does not always provide a detailed reason for every rejection. In many cases you receive only a generic 'rejected' status, which makes diagnosis more difficult. This is exactly why having a preventive checklist before submitting a template for review is a practice that can save you days of waiting.
Template Categories and Category Constraints
WhatsApp Business API classifies templates into three main categories: MARKETING, UTILITY, and AUTHENTICATION. Each category has different rules about what you can write, how you can use variables, and in which contexts you can send the message. Choosing the wrong category is one of the most common mistakes and a cause of immediate rejection.
MARKETING templates can contain offers, promotions, and commercial messages, but they require that the user has given explicit consent to receive marketing communications. UTILITY templates must be strictly tied to transactions, service updates, or operational information already initiated by the user. AUTHENTICATION templates, finally, are reserved for OTP codes and identity verification and follow even stricter rules.
A frequent mistake is inserting promotional content into a template classified as UTILITY. For example, an order confirmation message that includes a discount for the next purchase is often rejected because it mixes the two categories. The solution is to separate the transactional message from the promotional one by creating two distinct templates.
- MARKETING: offers, promotions, newsletters, campaigns
- UTILITY: order confirmations, shipping updates, appointment reminders
- AUTHENTICATION: OTP codes, account verification, secure login
- Do not mix MARKETING content into UTILITY templates
Text Errors: What Meta Does Not Tolerate
The text content of a template is analyzed in depth. Meta uses automated systems and human reviewers to identify forbidden language, excessive promises, misleading phrases, or content that could harm the user. Certain expressions typical of aggressive marketing, such as 'FREE', 'CLICK NOW' in all caps, or promises of easy earnings, are automatic red flags.
Excessive use of emoji or capital letters can also lead to rejection. WhatsApp wants messages to have a natural tone and not resemble classic email marketing spam. A template filled with exclamation marks, emoji everywhere, and text in all caps has a high probability of being rejected even if the content is formally legitimate.
Another critical aspect concerns links included in the template. Links must be verifiable and must not be shortened using unrecognized URL shortening services. If you include a link, make sure the domain matches the website registered on your WhatsApp Business account. Links to different or suspicious domains are a direct cause of rejection.
- Avoid excessive capitalization and spam language
- Do not use unverified URL shorteners
- Limit emoji to natural contexts
- Do not make unrealistic or misleading promises
- The link domain must match the account domain
Correct Handling of Variables and Placeholders
Dynamic variables in WhatsApp templates use the syntax {{1}}, {{2}}, {{3}}, and so on. A common mistake is not providing concrete examples for each variable at the time of submission. Meta requires that every placeholder have a sample value demonstrating how it will be used in a real message. If you do not provide these examples, the template will almost certainly be rejected.
Variables must be used in a way that is consistent with the context of the message. You cannot create a template where the entire structure of the message depends on a variable, leaving the fixed body of the text completely generic or meaningless without it. Meta wants to see that the base text of the template makes complete sense even independently of the specific value inserted in the variable.
Another frequent problem involves templates with variables in call-to-action buttons. If you use a dynamic URL in a button, you must specify the fixed domain and leave only the path variable. For example, 'https://your-site.com/order/{{1}}' is acceptable, while '{{1}}' as a full URL will be rejected because it does not allow Meta to verify the destination of the link.
How to Read the Rejection Message and Diagnose the Problem
When a template is rejected, the Meta Business Manager panel shows a 'Rejected' status with a code or a brief description. The most common error codes include 'TAG_CONTENT_MISMATCH' (content inconsistent with the category), 'INVALID_FORMAT' (invalid format), 'SCAM' (content flagged as potentially deceptive), and 'ABUSIVE_CONTENT' (content that violates policies). Each code points you in a precise direction for action.
If you use the WhatsApp Business API directly through API calls or a platform like Kuba Labs, you can obtain additional details about the rejection reason via webhooks or the template management dashboard. Having access to these technical details greatly speeds up the diagnosis process and allows you to correct the template in a targeted way instead of proceeding by trial and error.
A useful approach is to compare the rejected template with similar templates already approved in the same account. If you have an approved UTILITY template for order confirmations, you can use it as a stylistic and structural model for creating new variants. This internal benchmarking is often more effective than any generic guideline.
- TAG_CONTENT_MISMATCH: change category or revise the content
- INVALID_FORMAT: check variable syntax and structure
- SCAM: remove elements that appear deceptive
- ABUSIVE_CONTENT: review the text against WhatsApp policies
Practical Strategies for Fixing a Rejected Template
Before resubmitting a template for review, carry out a full audit at three levels: category, text content, and variables. Do not limit yourself to correcting only the point you think caused the rejection. Templates are often rejected for multiple reasons at once, and fixing just one leads to a second rejection with a different reason, extending the waiting time even further.
Simplify the text. Templates that get approved fastest tend to be those with clear, direct language free of ambiguity. If your original template had a very commercial or aggressive tone, rewrite it using a more informative and neutral register. Often the difference between approval and rejection comes down to a few adjectives or the use of a softer call-to-action.
Test the template internally before submitting it for review. Many platforms, including Kuba Labs, offer preview tools that let you visualize the message exactly as it will appear to the end user, with sample values inserted in the variables. This step helps you identify visual or logical inconsistencies that could trigger an automatic rejection.
Review Timelines and How to Speed Up Approval
WhatsApp template review times range from a few hours to several business days, depending on the volume of requests and the complexity of the template. On average, Meta completes the review within 24 to 48 hours for simple, well-structured templates. Templates with borderline content, many variables, or dynamic buttons may take longer because they are subject to human review in addition to automated checks.
To speed up approval, follow some established best practices: submit templates on weekdays, avoiding weekends and global holiday periods such as Christmas or New Year, when Meta's review teams operate with reduced staffing. Use the correct language code for the template's language — a template in English must have the language tag 'en' and not 'it' — and make sure the template name is descriptive but not excessively long.
If you urgently need approval and your specific case justifies it, you can contact Meta Business support through the Business Help Center. This option is however recommended only when the template is technically correct and the rejection appears to be a false positive from the automated system. For templates with obvious problems, it is more effective to correct and resubmit directly.
Preventing Rejections with a Pre-Submission Validation Process
The most effective way to handle rejected templates is to avoid them in the first place. Building an internal validation process before every submission drastically reduces the rejection rate and saves you valuable time. This process should include a standardized checklist, a review by someone familiar with Meta's policies, and a test of the template with realistic sample values.
Kuba Labs integrates template creation support tools that guide you in choosing the correct category, structuring variables, and complying with the guidelines. Having a platform that handles this level of complexity lets you focus on content and communication strategy, leaving it to the technology to catch formal errors before the template is submitted for review.
Documenting approved templates over time is another investment that pays off. Build an internal library of already-validated templates, categorized by use case (order confirmation, abandoned cart recovery, appointment reminder, seasonal promotion) and use them as a basis for new communications. Iterating on already-approved structures is the safest strategy for maintaining a high approval rate and ensuring operational continuity in your WhatsApp campaigns.
- Create a pre-submission validation checklist
- Always use realistic examples for every variable
- Maintain a library of already-approved templates
- Check category, text, and variables separately
- Use API platforms that support automatic validation