# WhatsApp Template Library

> Start from a ready-written Avox template in any category, or from a Utility template Meta has already verified - browse, search, preview, and use.

Source: https://docs.theavoxai.com/templates/library

The template library gives you two places to start instead of a blank page:

- **Avox library** - templates written by Avox for everyday messages: order updates, reminders,
  login codes, offers, greetings and more, in Marketing, Utility and Authentication. You can change
  anything before submitting, and Meta reviews them like any template.
- **Meta's library** - Utility templates Meta has already verified. They start working instantly,
  with no review wait, but their wording is fixed.

Any Switchboard member (Admin or Manager) can browse the library and start a template from it.

## Where you'll find it

- **Templates page** - the **Template library** button opens the Avox library, and the **Start
  from Meta's template library** strip shows six featured Meta templates with a **Browse the full
  library** link.
- **Create template wizard** - step 1 has a **Start from the Avox library** card. Under **Utility**,
  the Meta featured strip appears and the **Browse Meta's Library** type opens Meta's tab.
- **The library page** - `/templates/library`, with an **Avox library** tab (the default) and a
  **Meta's library** tab. **Back to Create template** returns you to the wizard.
- **Premade automations** - a premade that sends a template, when you have no approved one yet,
  links straight to a matching Avox template. See [Premade automations](https://docs.theavoxai.com/automation#premade-automations).

## Avox library

### Browse and search

- **Search** - type in **Search Avox templates…**. It matches titles, descriptions, use cases,
  industries and the message text itself.
- **Use case** and **Industry** - two searchable menus narrow the list, for example **Payment
  reminder** or **Healthcare**.
- **Category** - **All**, **Utility**, **Marketing** or **Authentication**.
- **Cards** - each card shows the template's title and category, what it's for, the languages it's
  written in, and **Needs a sample image** (or video, or document) when its header is media.
- **No matches** - "No templates match." with a **Clear the filters** link.

Click a card to preview it. On a wide screen the preview sits on the right; on a phone it opens
under the card. The preview uses the same phone mockup as the wizard, filled in with example
values.

### Languages

Every Avox template is written in at least English (US); some also in Hindi or Spanish. When a
template has more than one, a **Language** menu above the preview switches the preview, and the
template starts in the language you picked. Authentication templates work in every language,
because Meta writes their text.

In the wizard you can still change the language. If the text you started with is in another
language, the wizard offers to **Load the** text in your new language. If the template isn't
written in that language at all, you see [AVX-3401](https://docs.theavoxai.com/error-codes/avx-3401) with buttons to switch
back - or keep your language and rewrite the text yourself before submitting.

### Use this template

**1. Pick a template and a language**

Click a card, then choose a language if the template offers several.

**2. Click Use this template**

Avox saves it as a new draft and opens the wizard at step 2 with everything filled in: name,
language, category, header, body, example values, footer and buttons. The summary box reads
"From the Avox library:" with the template's title.

**3. Adjust it**

Change the name, language or any of the content. Replace placeholder links such as
`https://www.example.com/...` with your own - the Content step reminds you while one is left.

**4. Submit to Meta**

Click **Submit to Meta**. Avox runs the same checks as any template, and Meta reviews it. It
appears in **Your templates**, usually as **Pending review**.

Notes on the preview tell you what to expect before you start:

- **Media headers** - "Meta reviews it against a real sample, so you'll upload your own image in
  the Content step." Submitting without one shows [AVX-3402](https://docs.theavoxai.com/error-codes/avx-3402). See
  [Header sample files](https://docs.theavoxai.com/templates/create#header-sample-files).
- **Authentication** - "Meta writes this message itself." You choose how the code is delivered
  and when it expires; the text and button can't be changed ([AVX-3403](https://docs.theavoxai.com/error-codes/avx-3403)).
- **Names** - Meta needs every template name to be unique per language. If you already have one
  with the same name and language, the template starts with the next free name, such as
  `order_confirmation_2`, and the preview says so. See [Duplicate names](#duplicate-names).

### What's in the Avox library

| Template | Category | Languages | For |
| --- | --- | --- | --- |
| Order confirmation | Utility | English, Hindi, Spanish | Confirming a new order, with a View order link. |
| Shipping update | Utility | English | Courier, expected date and a Track package link. |
| Delivery confirmation | Utility | English | Delivered notice with Report a problem / All good, thanks. |
| Payment reminder | Utility | English, Spanish | An invoice due soon, with a Pay invoice link. |
| Payment receipt | Utility | English | Thanks for a payment, with the receipt as a PDF header. |
| Appointment reminder | Utility | English, Hindi, Spanish | Upcoming appointment with Confirm / Reschedule. |
| Appointment confirmation | Utility | English | A newly booked appointment, with a directions link. |
| Login code | Authentication | Every language | A copy-code one-time passcode, expiring in 10 minutes. |
| Password reset code | Authentication | Every language | A copy-code one-time passcode, expiring in 5 minutes. |
| Welcome message | Marketing | English, Hindi | Welcoming someone who just opted in. |
| Feedback request | Marketing | English | Great / Okay / Poor rating buttons. |
| Abandoned cart | Marketing | English | Bringing a shopper back to their cart. |
| Back in stock | Marketing | English | A product photo and a Shop now link. |
| Price drop alert | Marketing | English | A wishlist item that got cheaper. |
| Event invitation | Marketing | English | An invite with I'll be there / Can't make it. |
| Renewal reminder | Utility | English | A plan renewing soon, with a Manage plan link. |
| Support ticket update | Utility | English | An update on a support request. |
| Review request | Marketing | English | Asking for a public review. |
| Festive greeting | Marketing | English, Hindi | A holiday greeting with your own festive image. |
| Referral invite | Marketing | English | A personal referral code to copy. |
| We miss you | Marketing | English | Re-engaging a customer you haven't heard from. |
| Cash on delivery confirmation | Utility | English, Hindi | Confirming a COD order before it ships. |
| Booking confirmation | Utility | English | Dates, guests and a Manage booking link. |

Every Avox template follows Meta's rules: variables numbered in order with an example for each,
Meta's length limits, valid buttons, no promotional wording in Utility templates, and an opt-out
line ("Reply STOP to unsubscribe") on Marketing ones. Meta still reviews each one, and can
re-categorise or reject it like any other template.

## Meta's library

The **Meta's library** tab is Meta's own catalogue of Utility templates. Meta has already verified
their content, so a template you create from it starts working instantly. Avox shows Meta's live
library, so what you see is always Meta's current catalogue.

> **Note**
>
> Meta's library needs a connected WhatsApp number. Until one is connected, it shows "Connect a
> WhatsApp number before browsing the template library" in place of templates. See
> [Connections](https://docs.theavoxai.com/connections).

### Browse and search

The tab is titled **Meta's own template library** and explains: "Already verified by Meta - pick
one and it starts working instantly, no review wait. Utility only, and the content itself is fixed;
you just fill in a few blanks."

- **Search** - type in **Search Meta's library…** and the results update as you type.
- **Cards** - each card shows the template's name, its body text, its topic, and an **Instant**
  badge. Hover a card to see **Start using**.
- **Load more** - the library loads 50 templates at a time. Click **Load more** at the bottom
  for the next set.
- **No matches** - "No matches - try a different search."

### Start using a Meta template

**1. Pick a template**

Click a card on the Templates page, in the wizard, or on the Meta's library tab. Avox saves it
as a new draft and opens the wizard at step 2.

**2. Name it and pick its language**

Enter a **Template name** (lowercase letters, numbers, and underscores, up to 512 characters)
and choose a **Language**. A box shows "From Meta's library:" with the library template's
name and an **Already verified - starts instantly** badge, and the wizard's summary bar shows
the type as **Meta's Library**.

**3. Choose the optional pieces**

Switch on any of the optional parts Meta offers: **Add a contact number**, **Add a "learn
more" link**, **Add a security recommendation**, and **Add a track-package link**.

**4. Click Start using**

Avox creates the template in your WhatsApp Business Account from Meta's library. You see
"Ready to use - already verified by Meta" and return to the Templates page, where the new
template appears in **Your templates**.

Meta library templates are always in the **Utility** category. They have no step 3: the content
is Meta's own. **Start using** stays disabled until the template has a name.

Once created, a library template works like any other in **Your templates**: it has its own
page with [insights](https://docs.theavoxai.com/templates/insights), it can be sent by an automation's **Send a template**
action once Meta shows it as **Approved**, and you can delete it from its page.

## Duplicate names

Meta needs every template in your WhatsApp Business Account to have a unique name and language
pair. The wizard checks your existing templates as you type: a clash shows
[AVX-3400](https://docs.theavoxai.com/error-codes/avx-3400) under **Template name**, with a **Use** button for the next free
name (such as `order_confirmation_2`). The same name is fine in a different language. Avox checks
again when you submit, in case another member took the name in the meantime.

## Template limit

Library templates count toward your Switchboard's template limit like any other. The limit is the
Switchboard's own plan (or its owner's plan), the same number Avox enforces when you submit. When
every slot is used, **Use this template**, **Start using** and **Create template** are disabled and
the page shows "You've used X of Y templates. Delete one to create a new one.
([AVX-3014](https://docs.theavoxai.com/error-codes/avx-3014))" with a **Manage templates** link. That link opens your
templates with rejected, paused and disabled ones highlighted - they can't be sent as they are, so
they're usually the first to delete.

## Drafts from the library

Picking a library template always creates its own new draft, so it never overwrites a template
you're already working on. It counts toward the 10-draft limit (see
[Drafts](https://docs.theavoxai.com/templates#drafts)). If you leave before submitting, resume it from the Templates page's
**Drafts** section.

## Related errors

| Code | When you see it |
| --- | --- |
| [AVX-3014](https://docs.theavoxai.com/error-codes/avx-3014) | Every template slot on your Switchboard's plan is in use. |
| [AVX-3016](https://docs.theavoxai.com/error-codes/avx-3016) | Meta didn't accept the template. Check the name and language, then try again. |
| [AVX-3027](https://docs.theavoxai.com/error-codes/avx-3027) | Meta's library couldn't be loaded. Reopen the page and try again. |
| [AVX-3029](https://docs.theavoxai.com/error-codes/avx-3029) | You already have 10 drafts. Delete one, then pick the template again. |
| [AVX-3031](https://docs.theavoxai.com/error-codes/avx-3031) | Saving the picked template as a draft failed. Pick it again. |
| [AVX-3400](https://docs.theavoxai.com/error-codes/avx-3400) | A template with that name already exists in this language. |
| [AVX-3401](https://docs.theavoxai.com/error-codes/avx-3401) | The Avox template isn't written in the language you picked. |
| [AVX-3402](https://docs.theavoxai.com/error-codes/avx-3402) | The header needs a sample image, video or document. |
| [AVX-3403](https://docs.theavoxai.com/error-codes/avx-3403) | Authentication templates use Meta's fixed one-time passcode format. |
| [AVX-3404](https://docs.theavoxai.com/error-codes/avx-3404) | Variables are out of order or missing an example value. |