Submit a template for approval
Categories, the review, and how to read a rejection — get a WhatsApp template approved.
On WhatsApp, every template must be approved before it can send. You write it here; WhatsApp (Meta) reviews it. Most approvals arrive within minutes to a few hours.
1. Pick the right category
The Category decides who reviews the text and how strictly:
- Marketing — promotions, offers, newsletters, anything a contact did not specifically ask for. Reviewed most strictly: opt-in language and a clear sender identity matter.
- Utility — transactional messages tied to something the contact did: an order confirmation, an appointment reminder, a delivery update. Easier to approve.
- Authentication — codes and verification messages only. On WhatsApp these are submitted as Utility.
Choosing Utility for what is really a promotion is the most common reason a template is rejected. Meta decides the final category from the text: if it approves under a different one, the editor says so under Category, and that is the category that applies. Changing the category of an approved template changes nothing until you resubmit and it is approved again.
2. Check the text before submitting
- The body must not start or end with a variable — open and close with real words. A period after the last variable is not enough.
- Keep real words around your variables: a short message that is mostly variables is rejected.
- No conditional blocks (
{{#if}} … {{/if}}) — WhatsApp templates are plain text. - Media links must point at an actual image/video file (ending in
.jpg,.png,.mp4…), not a web page. Upload image gives you one. - At most two link buttons per message (a Share with a friend button counts as a link). A reply or call button can still be the third. Emojis in button labels are removed for you.
- Carousel cards: title plus body at most 160 characters per card.
You do not enter example values for variables; one is supplied for each when you submit. The phone preview names any button WhatsApp will not deliver, and the Chat builder checks its draft against these rules while you can still change the wording.
3. Submit and wait
Save the template, then press Submit to Twilio at the top of the editor (with a direct Meta connection it reads Submit for approval). The badge moves from Not submitted to Pending approval, then to Approved or Rejected, refreshing on its own while it waits. Studio → Submissions lists every template's status in one table.
If a button cannot go to WhatsApp — a third link, a link whose whole address is a variable — a warning after submitting names it and why. RCS keeps it.
If it is not approved
- Rejected — the reason sits next to the badge. Template rejected maps the common ones to fixes.
- Failed — WhatsApp refused the approval request itself, before any review. The reason starts "WhatsApp refused the approval request".
- Blocked by account — the WhatsApp Business Account behind your sender may not create templates. Editing will not help: change the sending account in Integrations, then resubmit.
Edit the template and press Resubmit to Twilio (or Resubmit for approval) — resubmitting costs nothing.
Last reviewed November 9, 2026