Add to Preferred Sources
A WhatsApp template rejected notice means Meta's review decided that a message template breaks a formatting rule, a content policy or the category you chose for it, and the notice names which one. Most rejections are fixed by editing the wording and resubmitting, so the first job is reading the reason, not rewriting at random.
Templates are the pre-approved messages a business uses to start a conversation outside the 24-hour customer service window, which makes them central to the channel described in the complete WhatsApp marketing guide for South Africa. This post is a diagnosis guide: each Meta reason code is mapped to the causes worth testing, the check that tells them apart, and the next move. For writing templates that pass first time, see the WhatsApp message templates guide.
Quick Answer
When a WhatsApp template rejected notice arrives, read the reason in your email, WhatsApp Manager or your provider's dashboard, then match it to one of three families: invalid format (variables and layout), wrong category (promotional wording in a utility template, for example) or a content-policy breach. Fix the cause, then edit and resubmit, or appeal if the template was genuinely compliant. Meta's documentation says an approval decision can take up to 24 hours.
Template bounced for the third time?
Send us the rejection notice and the template text and ask for a free audit of your WhatsApp setup.
Get a free auditWhy Is a WhatsApp Template Rejected? Read the Reason Code First
A WhatsApp template is rejected when Meta's review finds an invalid format, a category mismatch or a policy breach, and the stated reason is the only evidence you have about what to change. Meta's developer documentation lists the labels that arrive through its status webhook: INVALID_FORMAT, INCORRECT_CATEGORY, TAG_CONTENT_MISMATCH, PROMOTIONAL, SCAM and ABUSIVE_CONTENT (Meta's template status webhook reference). Your provider's dashboard may show the same reason in plainer words.
A label is a symptom, so the table groups the codes into three families and lists several possible causes with a check that separates them. These are the main whatsapp template rejection reasons, drawn from Meta's webhook reference and its template review page. Meta's reference defines the two category codes in identical words and does not separate the three policy codes, so which cause triggers which code is not documented; treat the code-to-cause pairing as likely, not confirmed.
| Family and codes | Causes to test | Check that separates them | Best for (usual move) |
|---|---|---|---|
Format: INVALID_FORMAT | Variable syntax wrong; variable at the start or end; too many variables for the length of text; special characters inside a variable; character limit or emoji overuse | Read the template aloud with each variable replaced by a real value, then compare each variable against the rules in the next section | Edit the layout and resubmit; an appeal has little to argue from |
Category: INCORRECT_CATEGORY or TAG_CONTENT_MISMATCH | Promotional or persuasive wording inside a utility template; mixed content; a message that is not tied to one customer's order, account or booking | Delete every sentence that tries to persuade. If what remains is still useful to that one customer, the content may be utility | Strip the promotion and resubmit as utility, or resubmit honestly as marketing; appeal only if it is genuinely utility |
Policy: PROMOTIONAL, SCAM or ABUSIVE_CONTENT | Meta's review page lists Commerce Policy violations, requests for sensitive identifiers and potentially abusive or threatening content. An overdue-account reminder that reads as a threat is one illustrative case. Which of these triggers which code is not documented | Check whether the template asks for card numbers, bank details or ID numbers, then have someone outside the business read it as a customer would | Rewrite the message in plain, neutral wording; resubmitting identical text gives the reviewer the same reason |
| Duplicate (no code in the webhook list) | An existing template has the same body text | Search your template list for the same wording; one provider says duplicates with identical body or footer text are rejected | Reuse the approved template or change its purpose and wording |
The causes column is a set of hypotheses, not a verdict. A single rejection can have two causes at once, so fix every cause the checks turn up before you resubmit.
Takeaway: three families, three different fixes
Format rejections are mechanical and fixed by editing variables or layout. Category rejections are about what the message is for, so the fix is changing the wording or the category. Policy rejections need the content itself rewritten, because resubmitting the same text gives Meta the same reason to decline.
Formatting Rules That Trigger an Invalid-Format Result
A whatsapp template invalid format result means the layout or placeholders broke a structural rule, and it is the easiest family to fix because the rules are published. Meta's template review page lists these causes: variable parameters missing or with mismatched curly braces, special characters such as #, $ or % inside a variable, parameters that are not sequential, too many variables relative to the message length, and a template that starts or ends with a parameter (Meta's template review documentation).
Meta's template guidelines also set the placeholder syntax: positional parameters are index numbers starting from 1 in double curly brackets, such as {{1}} and {{2}}, while named parameters use lowercase letters and underscores, such as {{first_name}} (Meta's template guidelines). The same review page lists excessive emoji, character-limit breaches and duplicates among the other causes.
Likely to fail: {{1}}, your booking is confirmed for {{2}}. The message opens with a variable and gives the placeholders almost no surrounding text.
Safer layout: Hi {{1}}, your booking is confirmed for {{2}} at our Rosebank branch. Reply here if you need to change the time.
Two details matter for South African senders. Meta names $ and % as problem characters inside a variable, so as a practitioner precaution, not a Meta rule, keep % and currency symbols such as the Rand sign in the fixed text beside the placeholder. And if you write Afrikaans or isiZulu versions, check that the language you declare matches the text you wrote: Twilio's guidance lists language mismatches among its common causes of rejection (Twilio's template approval documentation).
Where Utility Ends and Marketing Begins
The utility-versus-marketing line decides most category rejections, and Meta draws it on the intent of the wording rather than on your intent in sending it. Meta's template guidelines say a utility template must be non-promotional, "not containing any promotional or persuasive intent", and must be either specific to or requested by the user, or essential or critical to them (Meta's categorisation guidelines).
The same page says templates with mixed content, such as an order update with a promo or a feedback survey with promotional content, are classified as marketing. That is why one tacked-on sentence changes the outcome.
Submitted as utility, likely to be treated as mixed content: Hi {{1}}, your order {{2}} has shipped. Shop our new winter range now and get a discount on your next order.
Utility only: Hi {{1}}, your order {{2}} has shipped and should reach you by {{3}}. Reply here if the delivery address needs to change.
If you want the promotional line, send it as its own marketing template, to people who have agreed to receive marketing. Two separate templates cost you a little more setup and remove the ambiguity.
Category can also change after approval. Meta says it runs recurring audits that recategorise incorrectly labelled templates: a utility template that should be marketing has its category changed while its status stays approved. It also says that since 16 April 2025, a business warned for categorisation misuse does not get 24 hours' notice before a category change (Meta).
Side note: category is also a billing decision
Meta charges per message delivered, and the rate varies by recipient country and category. Meta's pricing page lists South Africa as a named market and says South Africa's utility and authentication rates increased on 1 October 2026 (Meta's pricing documentation). Your monthly spend is delivered messages multiplied by the rate for each category, so a quiet recategorisation moves the bill. Read the South Africa line on the rate card before you decide what to send, and see the API pricing breakdown for South Africa for the wider cost picture.
Edit, Resubmit or Appeal: Which Move Fits
To resubmit a rejected whatsapp template is to change the wording or layout and send it through review again, while an appeal asks Meta to reverse a decision you believe was wrong. The right move depends on whether the template broke a rule or was misjudged, and the table sets out how to tell.
| Situation | Move | What to know | Best for |
|---|---|---|---|
| A formatting rule was broken | Edit and resubmit | Meta says templates can be edited and resubmitted through WhatsApp Manager | Variable, layout and emoji problems |
| Status is Rejected, and the template was compliant and you can show it | Appeal the rejection | Meta's template review page says an appeal decision is made within 24 hours and that appeals must include sample variable values | Rejected templates that genuinely meet the category and policy rules |
| Status is still Approved but the category was changed to marketing | Request a category review (a separate route from an appeal) | Qiscus's help centre, which describes Meta's process, says you can request a review up to 60 days from the date the category was updated; that window is Qiscus's report, not wording confirmed on Meta's own pages | Approved templates you believe were miscategorised |
| The wording really was promotional | Resubmit as marketing, or split into two templates | An appeal for wording that is not utility has little to argue from, so fix the wording first | Mixed order-update-and-offer messages |
| Your provider will not let you edit | Create a new template under a new name | Twilio's documentation says to submit a new template with a different name and says a rejected name cannot be reused for 30 days; other providers may differ | Accounts on a provider with this restriction |
The category-review click path is in WhatsApp Manager under Business Support Home, then Template Category Updates, where the outcomes show as In Review, Reversed or Unchanged (Qiscus help centre). That page is a provider's description of Meta's process and the only source for these screen names here, so confirm them in your own account.
For a whatsapp template appeal, keep the explanation factual and tied to the stated reason: what the message is, who receives it, and why it is tied to that customer's transaction. An appeal that argues about the product rather than the rule gives the reviewer nothing to reverse.
Unsure if it is a category problem or a policy problem?
Tell us what the message is meant to do and ask for a free consultation on which category fits.
Request a fit assessmentWhat Customer Feedback Does to Messages Already Approved
A paused or disabled template is an approved template that Meta has stopped after customers reacted to it, which is different from a rejection at review. Meta's webhook reference lists PAUSED as a status, describes FLAGGED as negative feedback that risks disabling, and says DISABLED means disabled due to user feedback. Meta's template management page adds that paused templates cannot be sent, and links pausing to recurring negative feedback or low read rates (Meta's template management documentation).
That makes your opt-in list part of template health. Meta ties pausing to negative feedback, and that feedback comes from recipients. A well-worded template sent to people who never agreed to hear from you invites exactly that. The WhatsApp opt-in strategies guide covers how to collect consent properly.
South African law adds a second test that Meta's approval does not replace. POPIA section 69 generally requires consent for electronic direct marketing, subject to exceptions such as the existing-customer route under section 69(3), and every such message must carry contact details to which the recipient can send a request that the communications stop (DLA Piper Africa's summary of the Information Regulator's guidance). A marketing template approved by Meta is a platform decision, not POPIA clearance, so build the opt-out line into the wording. The POPIA for marketing guide goes through the rules in more detail.
Takeaway: review fixes the message, feedback tests the audience
A WhatsApp template rejected at review is a problem with the text and is fixed at the editing stage. A paused or disabled template is a problem with who received it and how they reacted, so it is fixed by cleaning the opt-in process, not by rewording alone.
A Pre-Submission Checklist That Catches the Common Failures
A pre-submission checklist catches the rejections that are mechanical or predictable, so that the review wait is spent on templates with a fair chance of passing. Nothing below is a Meta requirement beyond the rules cited above; it is a working routine built on them.
- Name the purpose in one sentence. If you cannot say what the message is for, a reviewer will struggle too, and Infobip's compliance guidance says to state the purpose of the message clearly.
- Choose the category from the wording, not the other way round. Remove anything persuasive, then see what category the remaining text fits.
- Check every variable. Sequential from 1, no special characters, not at the start or end, and enough fixed text around each one.
- Supply realistic sample values. Meta's review page says appeals must include sample variable values, and good samples help any reviewer see the message in use.
- Remove requests for sensitive data. Meta's review page lists requests for sensitive identifiers as a cause, and a provider's compliance page names full card numbers, bank details and government IDs.
- Search your existing templates for the same text. Duplicates are a listed cause.
- Add the POPIA opt-out line to any marketing template.
If your use case is a service business, the same discipline applies to appointment and quote messages: the panel beater guide and the caterer guide show where utility-style messages fit in practice. If you are still deciding whether you need templates at all, the comparison of WhatsApp Business and the API is the place to start.
Why South African Businesses Choose Growth Pulse Media
Growth Pulse Media was founded by Dirk van Greuning, who built and scaled a large South African ecommerce business before starting the agency. All work is executed in-house, with a limited client load so each account gets senior attention. The WhatsApp marketing service page sets out how the channel fits into a wider acquisition plan.
Three checks from this post are worth running before any resubmission: whether each template's category matches its wording, whether the opt-in behind each send supports it, and whether the variable layout meets Meta's published rules. A WhatsApp template rejected close to a launch date is where they matter most, and a free audit is the route if you want a second opinion on them.
Who This Is NOT For
This post is the wrong fit for readers who need account-level intervention or a legal opinion rather than a diagnosis routine.
Your whole business account has been restricted or disabled. A rejected template is a review decision on one message. An account-level restriction is a separate matter that this post does not cover, and it goes through Meta's own support routes.
You are using the WhatsApp Business app without an API connection. Template review applies to the platform route, so if you are on the app alone, the Business app comparison is the better starting point.
You want a guarantee of approval. Meta decides, the review can use judgement, and no checklist removes that. This post reduces avoidable rejections and does not promise any outcome.
Want a second pair of eyes on your WhatsApp plan?
Ask for a free audit of the path from opt-in to message, so rejection and pausing risks show up before a launch. No obligation.
Book a free auditFrequently Asked Questions
These are the questions that come up most when a template comes back with a rejection notice.
Why was my WhatsApp template rejected?
A WhatsApp template is rejected when Meta's review finds a formatting problem, a policy breach or a category that does not match the content. Meta's documentation lists causes such as non-sequential variables, a variable at the start or end, special characters in a variable, sensitive-data requests and duplicate templates. The notice you receive names the reason, so start there.
How long does WhatsApp template approval take?
Meta's template review documentation says it can take up to 24 hours for an approval decision. Twilio's documentation says many templates are decided within minutes, and that those routed for human review can take up to 48 hours, so providers report different upper limits.
Can I appeal a rejected WhatsApp template?
Yes. Meta's template review page says an appeal is reviewed with a decision within 24 hours and that appeals must include sample variable values. Appeal only when the template was genuinely compliant; if the wording was promotional, resubmit it as marketing instead.
Can I resubmit a rejected WhatsApp template with the same wording?
You can edit and resubmit, but repeating identical wording after a policy or category rejection gives the reviewer the same reason to decline it. Change the cause the notice names. Some providers, such as Twilio, also require a new template name, and its documentation says a rejected name cannot be reused for 30 days.
What is the difference between a rejected and a paused WhatsApp template?
A WhatsApp template rejected at review failed before it was ever usable, while a paused template was approved and then suspended. Meta's documentation links pausing to recurring negative customer feedback or low read rates, and says paused templates cannot be sent. Cleaner opt-in and more relevant messages address a pause, not rewording alone.
Get your WhatsApp templates through review without the rework
Growth Pulse Media is a Johannesburg agency running Meta Ads and Google Ads, working with Shopify and Omnisend. Send us the template and the rejection notice and ask for a free consultation. No obligation, and we will get back to you within 24 hours.
Talk to Growth Pulse Media