> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Template Categories

> The three WhatsApp template categories — Marketing, Utility, and Authentication — what each is for, when to use each, and the key rules per category. Use when a customer asks what type of template to create, why their template was reclassified, what an authentication template is for, or why marketing templates are blocked for some users.

Every WhatsApp message template must be assigned one of three categories when submitted for
Meta approval. The category determines the pricing, delivery rules, and what content is
allowed. Choosing the wrong category is a common reason templates get rejected or
reclassified.

## 1. Marketing

**Purpose:** Promote products, services, or offers. Drive engagement and sales.

**Examples:** "Get 50% off this weekend only — shop now!" · "New arrivals are here" · "You
left something in your cart"

**Key rules:**

* Used for promotional content: discounts, offers, product launches, upselling
* WhatsApp limits how many marketing templates a user receives — if a user doesn't engage,
  Meta may stop delivering them (per-user marketing limit)
* **Error 131049** = a marketing template was blocked because the user hit their per-user
  limit. Wait at least 24 hours before retrying
* Marketing templates are **not delivered to US phone numbers**
* If a user replies to a marketing template, the 24-hour window opens

**Rule of thumb:** If the message drives a sale or promotes something, it is Marketing.

## 2. Utility

**Purpose:** Transactional notifications sent in response to a customer action — confirmations,
updates, reminders.

**Examples:** "Your order #1023 has been shipped" · "Payment of ₹2,500 received" · "Your
appointment is tomorrow at 10 AM"

**Key rules:**

* Must be **non-promotional** — no discounts, offers, upselling, or marketing
* Must be specific to the user's action or essential/critical information
* If Meta detects promotional intent in a Utility template, it **automatically reclassifies it
  as Marketing** (and the higher Marketing pricing applies)
* Supports up to 10 buttons: Call request, Copy code, Phone number, Quick-reply, URL

**Accepted use cases:** Order Confirmation · Shipping Update · Payment Reminder · Account Alert
· Feedback Survey · Emergency (outage, fraud alert, health, safety) · Privacy Policy Update

**Rule of thumb:** If the message confirms something the customer already did or alerts them to
something essential, it is Utility.

## 3. Authentication

**Purpose:** Send one-time passwords (OTPs) and verification codes only.

**Examples:** "123456 is your verification code." · "Use 789012 to verify your login."

**Key rules:**

* Only for OTP-based flows: login verification, account recovery, identity verification,
  security checks, sign-up verification
* **Only Authentication templates can send OTPs** — do not put OTPs in Marketing or Utility
* Authentication messages are only delivered to the user's **primary device**, not
  secondary/linked devices
* No header, footer, or URL buttons allowed — body only with the OTP code

**Rule of thumb:** If the message contains a verification code or OTP, it must be
Authentication.

## Category comparison

|                       | Marketing      | Utility              | Authentication  |
| --------------------- | -------------- | -------------------- | --------------- |
| Purpose               | Promote / sell | Transact / notify    | Verify identity |
| Promotional content   | Yes            | No                   | No              |
| OTP / verification    | No             | No                   | Yes             |
| US number delivery    | No             | Yes                  | Yes             |
| Per-user limit        | Yes            | No                   | No              |
| Auto-reclassification | —              | → Marketing if promo | —               |

## Reference images

<Frame caption="A Marketing template in the Meta dashboard — used for promotions and offers.">
  <img src="https://mintcdn.com/chatsyncs/rnzqBC-k4H7wWU35/images/meta-api/templates/template-categories/marketing-template-example.png?fit=max&auto=format&n=rnzqBC-k4H7wWU35&q=85&s=d23babb172e4f2557fb515622ab9c990" alt="Marketing template example" width="2321" height="1416" data-path="images/meta-api/templates/template-categories/marketing-template-example.png" />
</Frame>

<Frame caption="A Utility template — order confirmations, shipping updates, and essential notifications.">
  <img src="https://mintcdn.com/chatsyncs/rnzqBC-k4H7wWU35/images/meta-api/templates/template-categories/utility-template-example.png?fit=max&auto=format&n=rnzqBC-k4H7wWU35&q=85&s=bda3bd1e0986982f75e64e177cd8d1f4" alt="Utility template example" width="590" height="452" data-path="images/meta-api/templates/template-categories/utility-template-example.png" />
</Frame>

<Frame caption="An Authentication template used to send an OTP verification code.">
  <img src="https://mintcdn.com/chatsyncs/rnzqBC-k4H7wWU35/images/meta-api/templates/template-categories/authentication-template-example.png?fit=max&auto=format&n=rnzqBC-k4H7wWU35&q=85&s=772545385600e9ac3fbaac3360865587" alt="Authentication template example" width="2224" height="2211" data-path="images/meta-api/templates/template-categories/authentication-template-example.png" />
</Frame>

<Frame caption="Authentication template messages are delivered only to the user's primary WhatsApp device.">
  <img src="https://mintcdn.com/chatsyncs/rnzqBC-k4H7wWU35/images/meta-api/templates/template-categories/authentication-primary-device.png?fit=max&auto=format&n=rnzqBC-k4H7wWU35&q=85&s=a3aa2194e3996edcbf70a212c319a2bf" alt="Authentication primary device" width="576" height="1068" data-path="images/meta-api/templates/template-categories/authentication-primary-device.png" />
</Frame>

## Frequently asked

<AccordionGroup>
  <Accordion title="Which template category should I use?">
    Marketing for promotions and offers. Utility for order/payment/shipping notifications
    triggered by a customer action. Authentication for OTP and verification codes only.
  </Accordion>

  <Accordion title="Why was my Utility template reclassified as Marketing?">
    Meta detected promotional language (discount, offer, upsell) in a template submitted as
    Utility. Remove all promotional content and resubmit, or accept the Marketing
    classification.
  </Accordion>

  <Accordion title="How do I send an OTP via WhatsApp?">
    Use an Authentication template. Only Authentication templates can carry OTP codes. Do not
    put OTPs in Utility or Marketing templates.
  </Accordion>

  <Accordion title="Why aren't my marketing templates being delivered?">
    Two possible reasons: (1) the recipient is a US number — marketing templates are not
    delivered to US phone numbers, or (2) the user has hit their per-user marketing message
    limit (Error 131049). Wait 24 hours before retrying.
  </Accordion>

  <Accordion title="What is Error 131049?">
    WhatsApp blocked delivery of a marketing template because the user has reached their
    per-user marketing message limit or the business retried too many times. Wait at least 24
    hours before sending another marketing template to that user.
  </Accordion>
</AccordionGroup>

## Gotchas & common mistakes

<Warning>
  * **Putting a discount in a Utility template** — Meta reclassifies it as Marketing
    automatically. The higher Marketing price applies.
  * **Sending OTPs in a Utility template** — only Authentication templates can send OTPs.
  * **Marketing to US numbers** — WhatsApp does not deliver marketing templates to US phone
    numbers. Use Utility or a different channel for US customers.
  * **Ignoring Error 131049** — retrying immediately makes it worse. Wait at least 24 hours.
  * **Authentication on secondary devices** — OTP messages only go to the primary device.
</Warning>
