WhatsApp Business API

WhatsApp template approval: why templates get rejected and how to fix them

Most template rejections come down to category, variables or tone. How Meta reviews templates, why utility templates get recategorised and how to fix them.

  • 4 min read
  • Updated
  • By Ashmit Arya
On this page (9)
  1. What is a template, and when do you need one?
  2. How does Meta review a template?
  3. Why do templates get rejected, and how do you fix it?
  4. What if Meta changes my template's category?
  5. What do I do with a rejected template?
  6. Templates keep being paused. Why?
  7. Common mistakes
  8. Sources
  9. Frequently asked questions

A rejected template feels arbitrary the first time, and templates are central to everything in the WhatsApp Business API. It stops feeling that way once you know what the reviewer, mostly software, is checking. This guide covers what Meta checks, the rejections people hit most, and how to fix each one.

What is a template, and when do you need one?

A template is a message approved in advance by WhatsApp. You need one whenever you message someone outside the 24-hour window. In Meta's words, template messages are the only type of message that can be sent to a WhatsApp user outside a customer service window. If that is new to you, start with the 24-hour window explained.

Every template must be one of three categories, and the category also decides what you pay:

Marketing

  • Offers, launches, re-engagement, anything that promotes
  • The most flexible category, and the catch-all for mixed or unclear messages
  • Charged every time it is delivered

Utility

  • Follows something the customer did or asked for: an order, a booking, a payment
  • Must be non-promotional
  • Charged per delivered message, rate set by Meta; check your rate card

Authentication

  • One-time passcodes only
  • The most restrictive: no URLs, media or emojis
  • Uses Meta's pre-built authentication template

How does Meta review a template?

Templates are reviewed automatically when you create or edit them. Meta says a review can take up to 24 hours, and an approved template shows the status APPROVED. You cannot send a template until it is approved.

Responseify message templates list filtered by Approved, In review and Rejected status

What to notice: the status filters at the top show how many templates are approved, in review or rejected. Only approved ones can be sent.

Why do templates get rejected, and how do you fix it?

  1. 1

    Wrong categorymost common

    Promotional content submitted as utility. If it sells, nudges or discounts, it is marketing. Resubmit as marketing, or remove the promotion.

  2. 2

    Variables in the wrong placevery common

    Meta rejects templates where a variable is the first or last thing in the message. Put words before and after every variable.

  3. 3

    Too many variablescommon

    If the message is short and full of placeholders, Meta flags the ratio. Write more fixed text, or use fewer variables.

  4. 4

    Variables out of ordercommon

    Use {{1}}, {{2}}, {{3}} in order with none missing.

  5. 5

    Unclear purposecommon

    A reviewer should understand in a few seconds why the customer is receiving this. Say it.

Meta documents several of these as named error codes: for example leading or trailing parameters are not allowed, and parameters words ratio exceeds the limit. Treat them as a checklist:

  • The message says who it is from and why the customer is getting it
  • Every variable has words before and after it
  • Variables are numbered {{1}}, {{2}}, {{3}} with none missing
  • There is real fixed text, not just a string of variables
  • The category matches the intent: promotion is marketing, never utility
  • Sample values for each variable look like real data

In Responseify's template editor (how to create one), the body field reminds you to use {{1}}, {{2}} in a contiguous order, which catches the most common formatting rejection before you submit.

Responseify new template form showing the body text and footer fields with variable guidance

What if Meta changes my template's category?

This surprises many businesses. Meta can recategorise an approved template automatically if its content does not match the category you chose. For a utility template that is really marketing:

  • It stays APPROVED and keeps working.
  • Meta gives about one day of advance notice (waived for repeat cases).
  • Only the category changes, which moves the price from utility to marketing.

So a "utility" template with an offer slipped in can quietly start costing marketing rates. Keep utility templates strictly about the customer's own order, booking or request. For how this affects your bill, see WhatsApp Business API pricing in India.

What do I do with a rejected template?

Read the reason, fix that one thing, and resubmit. Do not resubmit the identical text; it will fail the same way.

A rejected template in Responseify showing the reason for rejection and a Resubmit button

What to notice: the reason is shown right on the template, with a Resubmit button. The text in this picture is an example.

Not sure where to start? Responseify has a library of 98 starter templates across 16 industries, written to follow Meta's content rules. They still go through Meta's normal review.

Responseify template library with search, industry and use-case filters

Templates keep being paused. Why?

Meta tracks quality. Templates that get negative feedback from multiple customers, or low read rates, can show Active - Low Quality and, if it continues, be paused so they can no longer be sent. The fix is on the sending side: message only people who want to hear from you, and make the message worth reading. Meta's messaging policy also requires opt-in permission and honouring requests to stop.

Common mistakes

  • Using utility to avoid marketing rates. Meta can recategorise it, and you lose the saving anyway.
  • Copying a template from a blog post unchanged. Reviewers see the same text from thousands of senders.
  • Resubmitting without changing anything.
  • Building authentication templates by hand. Meta requires its pre-built authentication template with a one-time password button. In Responseify, create these in Meta WhatsApp Manager and sync them in.

Sources

  • Meta, template fundamentals: templates outside the customer service window, categories, automatic review up to 24 hours, quality statuses and pausing.
  • Meta, template categorization: category definitions, automatic recategorisation, one day of notice, pricing impact.
  • Meta, error codes: leading or trailing parameters, parameter-to-words ratio.
  • WhatsApp, Business Messaging Policy: opt-in and honouring opt-out requests.

Frequently asked questions

How long does WhatsApp template approval take?

Templates are reviewed automatically, and Meta says a review can take up to 24 hours. Many are approved much sooner.

Why was my utility template changed to marketing?

Meta recategorises approved templates that do not match the utility definition, usually because of promotional content. The template keeps working, but it is billed at the marketing rate.

Can I edit a rejected template?

Yes. Fix the reason and resubmit. Editing triggers a new automatic review.

Do I need an approved template to reply to a customer?

Not inside the 24-hour window. Free-form replies are allowed there (Meta decides which messages are charged; check your rate card). Templates are for messaging outside it.

Why do I need to number my variables in order?

Meta expects {{1}}, {{2}}, {{3}} in sequence. Gaps or out-of-order numbers cause format rejections.

About the author

Ashmit Arya · Founder, Responseify

Builds Responseify, a WhatsApp CRM for Indian businesses, and tests what these guides describe in the product himself. Every number here is sourced and dated, and posts are updated when the rules change.

Connect on LinkedIn
  • Last reviewed .
  • Where we give figures about our own examples, we say so and show how we counted.
  • Found a mistake or an out-of-date rule? Email us and we will correct it. More about us on the About page.
Share on WhatsApp

Keep reading

See the features in Responseify