Why WhatsApp rejected your message template

A rejected template is the most common thing to go wrong in the first week on the WhatsApp Business Platform. It is also the easiest to fix, once you know what the reviewer is looking at.

Meta reviews templates automatically and by hand. A decision can take up to 24 hours. You find out through WhatsApp Manager, by email to your Business Suite admins, and through the message_template_status_change webhook — so if you have built your own integration, you can catch the rejection in code rather than by checking a dashboard.

The causes fall into three groups.

1. Variables and formatting

This is the largest group, and none of it is about your intentions. It is about the placeholders — the {{1}} and {{2}} values you fill in at send time.

A template is rejected when:

• Braces are missing or mismatched. {{1} and {1}} both fail.
• A variable contains a special character such as #, $ or %.
• Variables are not sequential. Use {{1}}, {{2}}, {{3}} in order. Skipping to {{4}} fails.
• There are too many variables for the length of the message. A short message that is mostly placeholders looks like a way to smuggle unreviewed content past the reviewer, and is treated as one.
• The message starts or ends with a variable. There has to be real text around it.

That last rule catches people out most often, because a message like {{1}}, your order has shipped reads perfectly well to a human. Add a word in front of it.

Excessive emojis relative to the length of the message will also fail, as will a duplicate template — one whose body and footer match a template you already have. Meta does not apply the duplication check to authentication templates.

2. The wrong category

Every template is submitted as marketing, utility or authentication. Categorisation is checked, and a mismatch is a rejection reason on its own.

The temptation is obvious, because utility messages cost less than marketing ones. A message that says “your order has shipped — and here is 20% off your next one” is a marketing message with a utility sentence at the front. Submit it as utility and it comes back.

The fix is usually to split it into two templates rather than to argue the category.

3. Policy

Three kinds of content are refused outright:

• Content that breaks the WhatsApp Commerce Policy, which governs what may be sold and transacted.
• Content that breaks the WhatsApp Business Policy — most commonly asking people for sensitive identifiers they should never send over chat.
• Abusive or threatening content. Meta names threatening a customer with legal action as an example. Payment-reminder templates are where this appears most often, usually written more harshly than intended.

Spam or scam-like content is refused too. Prize claims, urgency about accounts being closed, and anything that reads like a phishing message will fail even when the underlying business is legitimate.

Fixing it

You can edit a rejected template and submit it again. Work through the list above in order — formatting first, because it is the most common cause and the quickest to check.

If you believe the decision is wrong, you can appeal, and the appeal must include a sample of the message. Meta aims to decide within 24 hours.

One thing worth doing before you resubmit anything: read the template out loud as though you were the customer receiving it, without context, on a Sunday evening. Most policy rejections become obvious at that point.

After approval: quality rating

Approval is not the end of it. Once a template is live it carries a quality rating, based on how people react to it.

The statuses run from Active – Quality pending through High, Medium and Low. A template at Low quality is receiving negative feedback or is not being read, and is at risk. From there it can be Paused, which stops it sending, and then Disabled.

The practical consequence: a template that is approved but unwanted is worse than one that was rejected. A rejection costs you a day. A paused template stops a campaign you were relying on, usually at the point you most wanted to send it.

Where to go next

• Managing message templates — creating, submitting and tracking templates inside Baat
• What counts as opt-in on WhatsApp — the other half of keeping quality high
• WhatsApp now charges per message — why the category you choose also changes the cost