Lorixen.
EN

WhatsApp Business API Message Template Rejected: Common Reasons and Fixes

Short answer: Most WhatsApp template rejections fall into a few groups: the category does not match the content (a promotion submitted as utility), the variables are badly placed (at the very start or end, side by side, or too many for the amount of text), the sample values are missing or unrealistic, or the wording breaks the commerce and messaging policies. Read the rejection reason in WhatsApp Manager, rewrite the template so each variable sits inside a clear sentence with a realistic sample, pick the category that honestly fits, and resubmit as a new template or request a review if you believe the decision was wrong. The category also affects what each message costs, so getting it right matters beyond approval.

Where to see why it was rejected

Open WhatsApp Manager in Meta Business Suite, go to message templates, and click the rejected template. The status shows a reason, sometimes broad ("does not comply with policies") and sometimes specific ("invalid format", "incorrect category"). Your provider's dashboard may display the same reason if you manage templates through a third-party platform. Note the reason before editing anything, because it tells you which section below to focus on.

The three categories, in plain terms

Category Purpose Example
Utility Updates about a specific transaction or account the customer already has with you Order shipped, appointment tomorrow, payment received
Marketing Anything promotional, re-engagement or general news Sale this weekend, new menu, "we miss you"
Authentication One-time passcodes for logins or verification Your verification code is 482911

The test Meta applies is the content, not the name you give it. A message that confirms an appointment and then adds "book a facial and get 20% off" has become marketing. Mixing the two is the most common category problem.

Category and cost

Meta prices template messages by category, and marketing is typically the more expensive one, with rates varying by the recipient's country. Check the current WhatsApp pricing page for your markets. Meta may also reassign a template to a different category after review, in which case the new category's pricing applies. That is why stuffing promotional lines into a utility template is a poor shortcut even when it slips through.

Variable placement rules

Variables are written as numbered placeholders, {{1}}, {{2}} and so on. Common formatting reasons for rejection:

  • Starting or ending with a variable. "{{1}}, your table is booked" may be rejected; "Hi {{1}}, your table is booked for {{2}}." gives context on both sides.
  • Adjacent variables. "{{1}} {{2}}" with nothing between them looks like a blank message the sender can fill with anything. Put words between them.
  • Too many variables for the text. A template that is mostly placeholders with a few connecting words reads like a free-form message in disguise. Write more fixed text and fewer variables.
  • Wrong numbering. Variables must run in sequence without gaps: 1, 2, 3, not 1, 3.
  • Formatting characters inside placeholders or unusual symbols around them.

A rejected appointment reminder and its fix:

Rejected: {{1}} {{2}} at {{3}}. {{4}}

Approved style: Hello {{1}}, this is a reminder of your appointment at Riverside Dental on {{2}} at {{3}}. Reply YES to confirm or call us to change the time.

Sample values

When you submit a template with variables, you must provide an example for each. Reviewers read the template with those examples filled in. Problems arise when samples are:

  • Missing or left as "test".
  • Unrealistic, such as "aaaa" for a name.
  • Suggesting different content than the fixed text, for instance a sample value containing a discount code in a utility template.

Use believable examples: a typical first name, a plausible date and time, a real-looking order number like "A10457".

Content that gets templates refused

Templates must comply with WhatsApp's business and commerce policies. Common trouble spots:

  • Products or services restricted by those policies.
  • Threatening or abusive language, for example aggressive debt collection wording.
  • Requests for sensitive data such as full card numbers or passwords.
  • Shortened links that hide the destination; use your full domain instead.
  • Misleading urgency or claims.
  • Spelling and grammar so poor that the message looks like spam.

If you operate in a regulated area, keep the wording plain and factual, and check the policies before submitting.

Buttons, headers and media

Rejections also come from the extra components:

  • A URL button pointing to a domain that does not match your business, or a broken link.
  • A header image that contains promotional text in a utility template.
  • A dynamic URL suffix variable that could send users anywhere.

Keep buttons to the actions the message really needs, such as "View order" or "Reschedule".

Rewriting and resubmitting

  1. Read the reason and decide which group above it belongs to.
  2. Remove any promotional line from utility templates; create a separate marketing template if you need that message.
  3. Rewrite with fixed text around every variable and fewer variables overall.
  4. Add realistic samples for each.
  5. Give the template a new, clear name such as appointment_reminder_v2, since a rejected template's content cannot simply be edited in every case.
  6. Submit and wait for the review result before building the workflow that depends on it.

Appeals

If you believe a template follows the rules and was rejected anyway, WhatsApp Manager offers a way to request a review of the decision. Explain briefly why the content fits the chosen category and quote the transaction it relates to. Appeals take time, so in parallel, submit a more conservative version you can use meanwhile.

How category affects delivery

Beyond cost, marketing messages are subject to additional limits per user and are more sensitive to how recipients react. If many people block or report a marketing message, the template's quality rating drops and Meta may pause it. Utility templates tied to a real transaction rarely face this, provided they stay transactional. Write each template so the recipient immediately recognises why they are getting it.

FAQ

Can we edit an approved template?

Approved templates can be edited within limits set by Meta, and edits go through review again. Plan changes in advance rather than right before a campaign.

Why was our order update marked as marketing?

Usually because it contained a promotional line, a discount, or a "shop again" link. Remove those and resubmit as utility.

How long does review take?

Often it is quick, but it can take longer at times. Do not schedule a launch around a template that has not been approved yet.

Do we need separate templates for each language?

Yes. Each language version of a template is submitted and approved separately.

If you are stuck on template approvals or want reminders built on top of the API from your booking system, contact us and we will help you get them through.

Sources

WhatsAppBook a call