Blog · WhatsApp templates
Why Meta rejects your WhatsApp template, and how to fix it before you resubmit
Meta rejects a WhatsApp template for one of three reasons: format, category or content. Format is the most common: a variable at the very start or end of the body, a badly written variable or missing sample, text over the length limits, or a malformed button URL. All of those take two minutes to check before you submit.
Key takeaways: Check format and category yourself before submitting, because a person only reviews the content. If you are already rejected, read Meta's reason first, fix only what failed, then resubmit.
How does Meta review a WhatsApp template?
Meta reviews every template before you can use it, and it either approves it or rejects it with a reason. You need templates because once 24 hours have passed since a customer last wrote to you, a Meta-approved template is the only way to message them first. Each template is submitted with a category (marketing or utility for a store; authentication is for login codes), a body and, optionally, a header, a footer and buttons. A rejection is not a disaster, but it costs a review cycle: you fix it, resubmit and wait again. If the template was meant for a dated campaign, such as a launch or a sale, that wait is exactly the time you do not have.
Which format mistakes cause most rejections?
Most rejections come from rules about the text itself, which is why you can catch them before submitting. Meta publishes the limits and structure in its template components reference, including the 1,024-character body limit, 60 characters for header and footer, and 25 for a button label. Go through this list on every template:
- Length. Body up to 1,024 characters; header and footer up to 60 each; each button label up to 25.
- Well-formed variables. Exactly
{{1}},{{2}}and so on, numbered from{{1}}with no gaps.{{ 1 }}or{{name}}will not pass. - Never first or last. The body cannot start or end with a variable, or put two variables side by side with nothing between them, because the reviewer cannot tell what the message will say.
- Header and footer. The header takes at most one variable,
{{1}}; the footer takes none. - A sample for every variable. Meta asks for an example value for each one. Use something believable, like a real-looking name or product, not “test” or “123”.
- Link buttons. A label and a URL that starts with
https://. Only one variable is allowed,{{1}}, and only at the end of the URL.
What does a rejected template look like, and how do you fix it?
The most common rejection is a message that opens with the customer's name, because starting that way feels natural. The fix is small: put a word in front of the first variable and a sentence after the last one. The message says the same thing, but it no longer has a blank at either end, so the reviewer can see what it will read like. Here is the same template before and after:
| Version | Body text | Result |
|---|---|---|
| Before | {{1}}, your order is on its way. Track it here: {{2}} | Rejected: starts with a variable and ends with one |
| After | Hi {{1}}, your order is on its way. You can track it here: {{2}}. Any questions, just reply to this message. | Passes the format check |
Can the wrong category get a template rejected?
Yes, and it can also get a template re-categorized without you asking. A utility template is about something the customer already has going on, like an order, a shipment or a booking. A marketing template tries to sell something new: an offer, a launch, a cart they left behind. Meta explains how it assigns categories in its template category guidelines, and it bills and reviews them differently, so picking the wrong one is a common source of trouble.
| Category | Use it for | Typical mistake |
|---|---|---|
| Utility | Order confirmation, shipping update, booking, account notice | Adding “10% off your next purchase” to a shipping update |
| Marketing | Offers, launches, coupons, abandoned-cart reminders | Filing it as utility to avoid the stricter review |
The working rule is simple: if the message sells, file it as marketing from the start; if it informs, keep the selling out of it. A header image that looks like an ad can also tip a utility template into marketing. For the full explanation of why Meta moves templates between categories, read WhatsApp utility vs marketing templates: why Meta re-categorizes yours.
Should a marketing template have an opt-out button?
It is worth adding one even when Meta does not force you. Someone who no longer wants your messages and cannot find a way to stop them has two options left, block or report your number, and both count against your number's reputation. That feeds directly into the quality rating that decides how much you can send, which is covered in how to avoid a WhatsApp number ban. A button beats a footer reading “Reply STOP to unsubscribe”, because a footer cannot be tapped and customers end up typing long sentences that nothing recognizes as an opt-out. Pick a short, unambiguous label such as “Stop promotions” or “Unsubscribe”, and avoid “Cancel”: next to “Shop now” it reads as cancelling the action, not the subscription.
What if the problem is the content?
Then no automated check will find it, because a person at Meta reads what the message says and whether it follows their commerce and messaging policies. What you can do is write a clear message that says who is writing and why, with no promise your store cannot keep. Avoid vague urgency, claims you cannot back up, and anything that suggests the customer agreed to something they did not. It also helps to be sure the customer actually asked to hear from you, which is the subject of how to get WhatsApp opt-in consent from your customers.
What do I do once a template has been rejected?
Do not edit blindly and resubmit, because every blind attempt costs another review. Work through these steps in order:
- Read the reason. Meta returns it with the rejection. Fix what actually failed, not what you suspect.
- Run the text through the WhatsApp template checker. It is free and checks the format rules in this guide, with a preview of what your customer will see.
- Decide on the category. If that was the problem, either drop the promotional part or submit the message as marketing.
- Resubmit. If it was already approved and you only want to tweak it, see how to edit an approved WhatsApp template.
Where does Super Agent fit in?
Super Agent sends WhatsApp campaigns to the customers your store already has, such as a launch or a coupon, and shows you the sales those campaigns produced. That makes an approved template something you can measure, not just a message that went out. Setup is free with you on a 30-minute call, and the Gratis plan costs 0 US$ a month with no card and includes 250 WhatsApp campaign messages a month. One store that already uses it gets 55 times what it invested in orders when it writes on WhatsApp to its own customers. You can create your free account and have the first agent written for your site the same day.
What should I do after a template is approved?
Approval is the beginning, not the end. If the template is for abandoned carts, follow the guide to recovering abandoned carts on WhatsApp. If it is for a campaign, check first whether it can pay for itself with the WhatsApp campaign ROAS calculator, and tag your links with the WhatsApp link generator with UTM tracking so you can tell which orders it brought in. For a deeper look at costs, see how much a WhatsApp campaign costs and how to know it paid off.
Frequently asked questions
How long does Meta take to review a WhatsApp template?
Meta does not guarantee a fixed review time, and I would not plan a dated campaign around a lucky fast approval. Submit templates well before the campaign date so a rejection does not cost you the launch.
Can I resubmit a rejected template without changing it?
You can, but it will most likely be rejected for the same reason. Read the rejection reason, change what failed, and check the text with the template checker first.
Why was my utility template changed to marketing?
Usually because the text or header image reads like a promotion, for example a discount added to a shipping update. Remove the selling or accept the marketing category. See utility vs marketing templates.
Do I need a sample value for every variable?
Yes. Meta asks for an example for each variable when you submit, and a believable one, like a real-looking name or product, helps the reviewer understand the message. “Test” or “123” invites trouble.
Can a template start with the customer's name?
Not if the name is a variable at the very start of the body. Put a word before it, such as “Hi {{1}},”, and end the message with a sentence instead of a variable.
Before every submission, read the template once as the reviewer would: no variable at either end, a believable sample for each one, the right category for what the message does, and a clear way to opt out. That habit saves far more time than any fix after a rejection.
Send approved templates and see the sales they bring
Create your free account, no card needed. Super Agent sends WhatsApp campaigns to the customers you already have and shows the sales they produced.
Start for freeFree plan, no credit card. See plans and pricing.
Keep reading
- All the guides on the blog
- WhatsApp utility vs marketing templates: why Meta re-categorizes yours
- How to Avoid a WhatsApp Number Ban: Quality Rating, Limits and What to Do If You're Restricted
- How to Get WhatsApp Opt-In Consent From Your Store Customers
- How to recover abandoned carts on WhatsApp with Shopify or WooCommerce
- WhatsApp template checker and preview
- WhatsApp campaign ROAS calculator
- WhatsApp link generator with UTM tracking
- Free tools for online stores