Template rejected
The common rejection reasons, what each one means, and the fix that gets the template approved.
A rejected template tells you why next to its status badge in the editor (hover it for the full text). Work down this list — it covers the overwhelming majority of rejections.
Wrong category
A promotion submitted as Utility (or a code message as Marketing) is rejected for misrepresentation. Re-read the category guide: if the contact did not specifically trigger this message, it is Marketing.
Variable problems
- Body starts with a variable — open with real words:
Hi {{first_name}}, …not{{first_name}}, …. This one is refused the moment you submit. - Body ends with a variable — close with a sentence after the last variable. A period alone is not enough: the reviewer ignores trailing punctuation.
- Too many variables for the length — a short message that is mostly variables is rejected. Add real words, or remove a variable.
- Conditional blocks (
{{#if}} … {{/if}}) — WhatsApp templates have no logic. Rewrite the copy as plain text.
Media problems
The media URL must point at an actual file — ending in .jpg, .jpeg, .png, .webp,
.mp4 — served over HTTPS. A link to a page containing an image (an Instagram post, a
Google Drive view) is rejected. Host the file and paste the direct file link.
Button problems
- More than two link buttons — a WhatsApp message can carry at most two link buttons, and a Share with a friend button counts as one. A third link is left off the WhatsApp version and the preview names it; a reply or call button can still be the third button.
- A button linking to WhatsApp itself (
wa.me/…) is not allowed. Put that link in the message text instead. - A URL button must open a fixed web address. A button whose whole address is a variable is left off the WhatsApp version (RCS keeps it), and the warning after submitting names it.
- Emojis and special characters in button labels are removed from the WhatsApp version for you.
Failed or Blocked by account
- Failed means WhatsApp refused the approval request itself, before any review. The reason starts "WhatsApp refused the approval request", followed by the provider's own words. Fix what it names and submit again.
- Blocked by account is not about your template: the WhatsApp Business Account behind your sender may not create templates. Editing will not help — change the sending account in Integrations, then resubmit.
Policy rejections
Text that is misleading, aggressive, discriminatory, or sells restricted goods is rejected on policy regardless of category. These rejections name the policy; the fix is the copy, not the submission.
After the fix
Edit the template and submit again. Re-submissions are reviewed like new submissions and cost nothing. If you believe a rejection is wrong, fix nothing and contact support with the template name and the rejection reason — we can escalate it.
Last reviewed November 9, 2026