Buddy
All posts

Guides

WhatsApp message templates: categories, approval and 12 examples

Every WhatsApp message a business starts has to use a template Meta has approved. This guide explains the categories, how review works, why templates get rejected or paused, and gives you twelve examples to adapt.

The Buddy Team · · 12 min read

Guides

Message templates

WhatsApp message templates are pre-written messages that Meta reviews and approves before a business can send them. You need one whenever you message someone outside the 24-hour customer service window, which covers every campaign, reminder and notification you start yourself.

Templates decide what you can send, what it costs and whether it arrives. Pick the wrong category and you pay more or get recategorised. Format a variable wrong and Meta rejects it. Send one people don't want and it gets paused. This guide covers all of it, with twelve examples, and is part of our guide to choosing a WhatsApp marketing platform.

Why does WhatsApp need message templates?

When a customer messages or calls you, "a 24-hour timer called a customer service window starts" (Meta). Inside it you can reply with anything: text, images, voice notes, interactive messages. Once it closes, "you can only send pre-approved template messages". Templates are how Meta keeps business-started messages useful, identifiable and priced by what they are.

So templates aren't only for marketing. An order confirmation to someone who bought on your website, a reminder the day before an appointment and a welcome to someone who just subscribed on a web page all need templates, because the person hasn't messaged you in the last 24 hours. Templates also only go to people who have opted in, as our WhatsApp opt-in guide explains.

What are the WhatsApp template categories?

Meta sorts every template into one of three categories (template categorisation). You choose the category when you create the template, and Meta checks it. The category sets the price and the rules, so it's worth knowing exactly where the lines are.

CategoryMeta's definitionTypical uses
MarketingTemplates that help businesses "achieve a wide range of goals, from generating awareness to driving sales and retargeting customers"Launches, offers, newsletters, abandoned carts, back in stock, win-back
UtilityTemplates that "follow up on user actions or requests, since these messages are typically triggered by user actions". No promotional contentOrder confirmations, delivery updates, booking reminders, receipts, account alerts
AuthenticationTemplates that "verify a user's identity" with one-time passcodesLogin codes, sign-up verification, account recovery

Marketing vs utility: where does the line fall?

This is where most businesses slip. Two rules from Meta settle most cases:

  • Mixed content is marketing. A template that combines a utility message with promotion, such as an order update with a discount code, is categorised as marketing.
  • Some "helpful" messages are still marketing. Meta's own examples put an abandoned-cart reminder ("You left {{items}} in your cart!") and an alert that an item matching a saved search is available (in effect, a back-in-stock message) in the marketing category.

A quick test: would this message exist if the customer hadn't just done something, and does it try to sell? If it's triggered by their action and only tells them about it, it's probably utility. If it nudges them to buy, it's marketing. Meta's utility templates guide has more examples.

What happens if Meta recategorises a template?

When WhatsApp finds a utility template that should be marketing, it gives "a 1-day advance notice" before changing the category. The template stays usable but is charged as marketing from then on, and you have "60 days to review and appeal" (Meta). If you disagree, appeal. If you don't, take the promotional part out of the utility version and keep a separate marketing template for offers.

What goes into a WhatsApp template?

A template is built from parts, called components. These are Meta's limits, from its templates overview and components reference:

ComponentMeta's limitNotes
NameUp to 512 characters: lowercase letters, numbers and underscoresInternal only, customers never see it. Example: spring_sale_launch
LanguageRequiredEach language version is its own template under the same name
Header (optional)Text up to 60 characters, or an image, video, GIF or documentOne variable allowed in a text header
BodyUp to 1,024 charactersSupports several variables, such as {{1}} and {{2}}
Footer (optional)Up to 60 charactersGood for "Reply STOP to unsubscribe"
Buttons (optional)Button text up to 25 charactersUp to 10 buttons in total, with at most two URL buttons and one phone number button

Two account limits from the overview: a business portfolio that isn't verified can hold 250 templates per WhatsApp Business account (verified portfolios with an approved display name can hold up to 6,000), and you can create at most 100 templates per account per hour.

One layout tip: Meta's components reference says templates "composed of 4 or more buttons, or a quick reply button and one or more buttons of another type, cannot be viewed on WhatsApp desktop clients". If your customers use WhatsApp on a computer, keep to three buttons of one type.

How does WhatsApp template approval work?

You submit a template, Meta reviews it, and it comes back approved or rejected. Meta says "it can take up to 24 hours for an approval decision to be made" (template review). If your template uses variables, you must include a sample value for each one, so reviewers can see what a real message looks like.

Over its life, a template moves through a small set of statuses:

StatusWhat it means
In reviewSubmitted and waiting for Meta's decision.
Approved (active)Ready to send. Carries a quality rating.
RejectedNot approved. Meta gives a reason. You can edit and resubmit, or appeal.
Appeal requestedYou've asked Meta to look at a rejection again.
PausedTemporarily stopped because of negative feedback from recipients.
DisabledStopped after repeated quality problems.

Why do WhatsApp templates get rejected?

Most rejections are formatting problems you can fix in a minute. Meta's template review page lists these common reasons:

  • "Variable parameters are missing or have mismatched curly braces." Write {{1}}, never {1} or {{1}.
  • "Variable parameters contain special characters such as a #, $, or %." Keep variables to plain numbers.
  • "Variable parameters are not sequential." Use {{1}}, {{2}}, {{3}} in order, with no gaps.
  • "The template contains too many variable parameters relative to the message length." Add real words around your variables.
  • "The message template cannot start or end with a parameter." Don't open with {{1}} or finish on one.
  • Duplicates. Meta rejects a template whose body and footer exactly match one you already have (authentication templates are exempt).

Content matters too. Meta rejects templates that break WhatsApp's Commerce Policy (for example, offering goods or services it doesn't allow), that ask people for sensitive identifiers such as full payment card numbers, and that contain "potentially abusive or threatening content". If you think a rejection is wrong, appeal it. Appeals must include a sample, and Meta says "the appeal will be reviewed and a decision made within 24 hours."

A checklist before you submit

  1. 1Pick the category honestly. If there's any promotion in it, it's marketing.
  2. 2Start with a word, not a variable. "Hi {{1}}," is fine.
  3. 3End with words or punctuation after your last variable.
  4. 4Number variables in order and give a realistic sample for each.
  5. 5Say who you are. People block messages they don't recognise.
  6. 6Keep buttons short, specific and working. Test every link.
  7. 7Add a footer that explains how to opt out of marketing messages.

Can you edit an approved WhatsApp template?

Yes, within limits. Meta's template management rules say:

  • Only approved, rejected or paused templates can be edited.
  • "Approved templates can be edited up to 10 times in a 30-day window, or 1 time in a 24-hour window."
  • "You cannot edit the category of an approved template." To change category, create a new template.
  • Every edit goes back through review, so allow time before a send.
  • "If you delete an approved template, you cannot create a new template with the same name for 30 days."

A disabled template isn't the end either. Meta says "if an approved template has become disabled, you may also edit it and resubmit it for approval" (Meta).

12 WhatsApp message template examples

Adapt these to your business. The categories follow Meta's rules above, but Meta makes the final call when it reviews your template. All business names are made up.

UseCategoryExample body
Order confirmationUtilityThanks {{1}}, your Hartley Home order {{2}} is confirmed. We'll message you when it's on its way.
Delivery updateUtilityGood news {{1}}, order {{2}} is out for delivery today. Track it with the button below.
Appointment reminderUtilityHi {{1}}, a reminder of your appointment at Lumen Studio on {{2}} at {{3}}. Reply if you need to change it.
Payment receiptUtilityHi {{1}}, we've received your payment of {{2}} for invoice {{3}}. Thank you.
Event registrationUtilityYou're registered for {{1}}, {{2}}. Doors open at {{3}}. Show this message at the entrance.
Account change alertUtilityHi {{1}}, the email address on your account was changed on {{2}}. If this wasn't you, contact us straight away.
Welcome with an offerMarketingWelcome to Casa Nova, {{1}}. Here's 10% off your first order with code {{2}} this week. Reply STOP to unsubscribe.
New product launchMarketingHi {{1}}, our new {{2}} collection is live today. Subscribers get first pick before it sells out.
Limited-time offerMarketingHi {{1}}, {{2}} off everything until Sunday. Tap below to shop the sale.
Abandoned cartMarketingHi {{1}}, you left {{2}} in your basket. We've saved it for you. Tap below to finish your order.
Back in stockMarketingHi {{1}}, the {{2}} you asked about is back in stock. Sizes go quickly, so tap below to grab yours.
Weekly newsletterMarketingHi {{1}}, this week at Maya Learns: {{2}}. Tap below to read the full notes.

Notice two things. None of them starts or ends on a variable. And the order confirmation stays utility only while it stays free of promotion: add "and here's 10% off your next order" and it becomes marketing. For store-specific plays, see our guide to WhatsApp for ecommerce.

How does template quality rating work?

Approval is not the end. "Every template has a quality rating based on usage, customer feedback, and engagement" (Meta), and it updates over time:

RatingWhat Meta says it means
Green (high)The template has received little to no negative feedback.
Yellow (medium)Negative feedback from multiple users, or low read rates.
Red (low)Negative feedback from multiple users, or low read rates.
Unknown (pending)No user feedback or read-rate data yet.

Negative feedback means signals such as people blocking or reporting you after a message. Meta says quality ratings "factor into template pacing and template pausing", and ongoing negative feedback can change a template's status. Template quality also feeds your number's overall quality, which affects how many people you can message a day. Our guide to WhatsApp messaging limits and quality rating covers that side.

What is template pacing?

Template pacing is "a mechanism that allows time for customers to provide early feedback on templates" (Meta). It applies to marketing and utility templates that are new, recently unpaused, or don't have a green rating.

When a template is paced, some messages send normally and the rest are held while early recipients react. If feedback is positive, the held messages are released. If it's negative, the template is paused and the held messages are dropped.

The practical lesson: send a new template to your most engaged segment first. A warm audience gives positive early signals, so the template clears pacing and is ready for the wider send. Read rates and replies in your campaign metrics tell you which segment that is.

How to create WhatsApp templates with Buddy

Buddy's template builder submits templates straight to Meta from the app, so you never switch to WhatsApp Manager. Start from a ready-made starter (welcome, back in stock, order update, appointment reminder, offer) or a blank page, then fill in:

  • Template name in lowercase with underscores, a category and a language code such as en_GB. Buddy explains which category fits your message, so it isn't rejected or recategorised.
  • Header (optional): none, text up to 60 characters, an image (JPG or PNG up to 5MB), a video or a document such as a menu or timetable.
  • Body with {{1}}, {{2}} variables. Buddy asks for a sample value for each one, because Meta needs them.
  • Footer (optional) up to 60 characters.
  • Up to three buttons: Link (a URL), Quick reply or Call (a phone number), each with a label of up to 25 characters.

A live preview shows the message as it will look on a phone. After you submit, the templates list shows each one's status (approved, in review, rejected, paused, disabled or draft), its quality (high, medium or low) and a cost hint. If Meta rejects a template, Buddy translates the reason into what to change, so you can fix it and resubmit in minutes. Templates created in WhatsApp Manager sync into Buddy too, and status and quality update automatically.

Once a template is approved, use it in a WhatsNew: pick the template and language, fill the variables (with {name} personalisation for each recipient), add a media header if it has one, choose your audience and send or schedule. Buddy's eight campaign starters, such as a new product launch, a limited-time offer and an appointment reminder, are a good place to begin. Approved templates also power automations, such as a welcome sent the moment someone subscribes, as our WhatsApp auto-reply guide explains.

Frequently asked questions

How long does WhatsApp template approval take?

Meta says a decision can take up to 24 hours. A realistic sample for every variable and clean formatting give your template the best chance of passing first time.

Can I send a WhatsApp message without a template?

Only inside the 24-hour customer service window, which opens when the customer messages or calls you. Outside it, every message must use an approved template.

Is an abandoned cart message marketing or utility?

Marketing. Meta's categorisation guide uses an abandoned-cart reminder as a marketing example, and back-in-stock style alerts are marketing too.

How many WhatsApp templates can I have?

Up to 250 per WhatsApp Business account if your business portfolio isn't verified, and up to 6,000 once it's verified with an approved display name. You can create at most 100 per hour.

Why was my approved template paused?

Because recipients gave negative feedback, such as blocking or reporting, or read rates were low. Review who you sent it to and what it said, then send to a more engaged, clearly opted-in audience.

Can I fix a rejected or disabled template?

Yes. Edit a rejected template to address the reason Meta gave and resubmit it, or appeal if you think the decision is wrong. Meta also says a disabled template can be edited and resubmitted for approval.

Start sending WhatsApp campaigns with Buddy.

Connect your number, collect subscribers with consent and send your first WhatsNew.

Join the waitlist