WhatsApp Template Rejected? Every Reason Meta Sends, Explained
Meta sends eight rejection reasons and three share one description. What each actually means, all 14 template statuses, and how the appeal works.
هذا المقال متوفر باللغة الإنجليزية.
نُشر في
You submitted a template, waited, and got back one word. INCORRECT_CATEGORY. Or INVALID_FORMAT, or the genuinely alarming SCAM. No highlighted line, no explanation of which part offended — just an enum value and a campaign that is not going out today.
Meta sends one of eight values in the rejection reason field, and the first useful thing to know is that they are less informative than eight suggests: three of them carry an identical one-line description in Meta's own documentation, two more are exact synonyms of each other, and one does not mean your template was rejected at all. This page decodes all eight, lists the 14 statuses a template can hold, and walks the appeal — all from Meta's template review documentation and the status webhook reference.
The eight rejection reasons
| Value | What Meta's docs say | What it tells you in practice |
|---|---|---|
| INCORRECT_CATEGORY | The template's content doesn't match the designated category | You filed marketing copy as utility, or the reverse. The commonest judgement-call rejection. |
| TAG_CONTENT_MISMATCH | The template's content doesn't match the designated category | Word for word the same meaning as the row above. Treat them as one reason. |
| INVALID_FORMAT | The template has an invalid format | Mechanical and entirely preventable — almost always the variable parameters. See below. |
| ABUSIVE_CONTENT | Content that violates our policies | Threatening or harassing copy, including threatening legal action or public shaming. |
| PROMOTIONAL | Content that violates our policies | Same description as ABUSIVE_CONTENT and SCAM, but in practice promotional copy in a non-marketing category. |
| SCAM | Content that violates our policies | Reads like fraud — prizes, unexpected windfalls, urgency around money. |
| CATEGORY_NOT_AVAILABLE | Authentication templates for an unsupported region | Deprecated. If you see it, your authentication template targeted a region Meta does not cover. |
| NONE | The template was paused | Not a rejection. Your template was approved once and then paused for quality. Different problem, different fix. |
INVALID_FORMAT: the one you can prevent entirely
Format rejections are the good kind, because they are mechanical — the rules are published, and a template that follows them does not get rejected on format. Meta documents these causes:
- Variable parameters are missing, or have mismatched curly braces. Positional parameters take exactly two braces each side — {{1}}, not {1} or {{{1}}}.
- Variable parameters contain special characters such as a hash, dollar or percent sign.
- Variable parameters are not sequential — numbering must run 1, 2, 3 with nothing skipped.
- Two parameters sit directly next to each other with no text or punctuation between them.
- The template contains too many variable parameters relative to the message length.
- The message starts or ends with a parameter. Both are rejected; a template needs real text at each end.
- Character limits or text formatting are exceeded.
- The template duplicates an existing template. Note this check does not apply to templates categorized as authentication.
The last one catches more people than it should. If you are building near-identical templates for several branches or cities, the duplicate check will reject the second one — and because authentication templates are exempt, the behaviour looks inconsistent until you know the rule.
INCORRECT_CATEGORY: a judgement, not a bug
Category rejections are harder because there is no rule to follow mechanically — you are predicting a reviewer's reading of your copy. Meta's bar for utility is that the message is non-promotional and either specific to or requested by the user, or essential or critical to them. Anything that generates awareness, drives a sale or retargets is marketing. A single promotional sentence inside an otherwise transactional message is enough to move it.
If a template sits on the line, file it as marketing. It costs more per message but it gets approved, and a marketing template that sends beats a utility template that does not. We walked through the full categorisation test with worked examples in WhatsApp for recruitment, including what Meta does when it decides a live template was filed in the wrong category — which is a separate and more expensive process than a rejection at review.
The 14 statuses, and which ones mean trouble
Rejection is one state out of fourteen, and conflating them is why "my template stopped working" conversations go in circles. The status webhook can report: PENDING while under review, APPROVED, REJECTED, PAUSED, and IN_APPEAL while an appeal is open. Then the ones people rarely see until they bite — FLAGGED means the template has drawn negative feedback and is at risk of being disabled; DISABLED means that already happened; REINSTATED means it recovered and can be sent again; LOCKED means it cannot be edited; LIMIT_EXCEEDED means the messaging account has hit its template limit, so the problem is your account rather than this template.
How the appeal actually works
Two timings are worth planning around. A review decision takes up to 24 hours, and an appeal decision also comes within 24 hours. So a rejection discovered the morning of a campaign is a lost campaign, and the only real defence is submitting templates days ahead of needing them.
- Open the rejected template and read the reason value, holding in mind that it narrows the problem rather than naming it.
- Decide between editing and appealing. Rejected and paused templates can be edited an unlimited number of times, and an edit sends it back through review — which is the right move when the reason is INVALID_FORMAT or you accept the category call.
- Appeal when you believe the decision is wrong. An appeal must include a sample, which is the step most people miss: edit the template, use Add Sample to supply realistic values for every variable, then submit.
- Expect a decision inside 24 hours, with the status showing IN_APPEAL while it is open.
Supplying a genuine sample matters more than the wording of your case. A reviewer seeing "Hi {{1}}, your {{2}} is {{3}}" has no way to judge the category; the same template with "Hi Ayesha, your service booking is confirmed for Tuesday 3pm" is obviously utility. Most category rejections we help with are templates whose samples were placeholders.
Can a provider get templates approved faster?
No, and this is the part of the page that costs us a sales line. Template review is Meta's, it takes up to 24 hours, and no Business Solution Provider has a fast lane, a priority queue or an inside track. Any platform advertising "instant" or "guaranteed" template approval is describing something Meta does not sell. We are a Meta Business Partner (Tech Provider) and we cannot do it either.
What a platform can genuinely do is narrower and still useful: validate the format rules above before submission so you never spend a review cycle on a mismatched brace, prompt you for real sample values rather than letting placeholders through, surface the status webhook so a rejection reaches a human instead of sitting in a dashboard nobody opens, and keep approved templates from being archived out from under you. That is the honest answer to "which provider gets templates approved fastest" — the one that wastes the fewest of your own review cycles. Our help centre's template guidance covers the writing side, and the shared inbox is where status changes land.
أسئلة شائعة
How long does WhatsApp template approval take?
Up to 24 hours for a decision, per Meta's documentation, and an appeal also receives a decision within 24 hours. Many templates clear much faster, but 24 hours is the number to plan against — which means submitting templates several days before a campaign rather than the morning of it.
Which provider gets WhatsApp templates approved fastest?
None of them, because review is performed by Meta and no Business Solution Provider has a priority queue or fast lane. Any platform promising instant or guaranteed approval is advertising something Meta does not offer. What a provider can do is stop you wasting review cycles — validating format rules before submission, requiring real sample values, and making sure a rejection actually reaches a person.
Why does my rejection reason say NONE?
Because the template was paused rather than rejected. NONE is the value Meta sends in the rejected reason field when the cause is a pause, which happens to an already-approved template after recurring negative feedback or low read rates. The fix is different from a rejection: improve the message or the targeting, since resubmitting the same copy will not help.
What is the difference between a paused and a rejected template?
A rejected template never passed review, so nobody received it. A paused template was approved, sent, and then paused because of customer feedback or low read rates. Rejection is a content or format problem you can fix and resubmit; a pause is a signal that the people receiving the message did not want it.
Can I edit a rejected WhatsApp template?
Yes. Rejected and paused templates can be edited an unlimited number of times, and each edit sends the template back through review. Editing is the right path when the reason is INVALID_FORMAT or you accept Meta's category decision; appeal instead when you believe the decision itself was wrong, and remember an appeal must include a sample.
Why was my second template rejected as a duplicate?
Meta rejects templates that duplicate an existing template, which commonly catches teams creating near-identical messages per branch, city or product line. Use variable parameters to cover the variation in one template instead. The duplicate check does not apply to templates categorized as authentication, which is why the behaviour can look inconsistent.
بقلم
Saifullah AlamFounder — Spadasoft, WABPO & WAWCD
Saifullah Alam founded Spadasoft, WABPO and WAWCD. He builds WhatsApp Business API products and writes practical, no-hype guides about what actually ships.
تابع القراءة
WhatsApp for Recruitment: The Rules Hiring Teams Hit First
One job post, two hundred applicants, and replies that arrive over four days instead of four hours. That timing is what breaks WhatsApp hiring pipelines — and it decides which template category every message needs.
WhatsApp Number Verification Failing? Every Cause and Fix
Most verification failures are one of six documented error codes, and three of them just mean wait. Here is how to tell which problem you actually have before you start changing things.
WhatsApp Service Message Pricing: What Changes on October 1, 2026 — and What It Really Costs Your Business
The famous free 24-hour window is ending. From October 1, 2026, Meta charges for every service message after 1,000 free per number each month — and utility templates inside the window are billed too. Here is exactly what changes, what it costs, and how to shrink the bill before it arrives.
