Source: https://gitlab-test-org.docs.pageloop.ai/external-templates/whatsapp/create-utility-whatsapp-templates

# Create a Utility WhatsApp Template

Use a Utility template for transactional messages that follow an action the user already took, such as order confirmations, delivery updates, payment alerts and account notifications. Creating one takes four steps:

1. [Create the template](#step-1-create-the-template)
2. [Build the message](#step-2-build-the-message)
3. [Add more languages](#step-3-add-more-languages-optional) (optional)
4. [Save or send for approval](#step-4-save-or-send-for-approval)

> [!NOTE]
>
> Meta may automatically recategorize a Utility template as Marketing based on its template policies. Keep the content strictly about the user's existing activity, such as an order, payment, renewal or alert.

## Step 1: Create the template

Navigate to **Templates → External → WhatsApp Templates**, then click **Create**. Fill in the dialog and click **Create Template**.

![](assets/waext-v-2-utility-create-dialog.png)

| Field             | What to enter                                                                                                                   |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Template Name** | A unique name in lowercase, with underscores instead of spaces. For example, `order_shipped_update`.                            |
| **Integrations**  | The WhatsApp Business Account to create the template in. The template can only send messages from this account's phone numbers. |
| **Category**      | Select **Utility**.                                                                                                             |
| **Language**      | One or more languages. You can add or remove languages later.                                                                   |

## Step 2: Build the message

A Utility message has a header, body, footer and buttons. The Preview on the right shows how it looks.

![](assets/waext-v-2-utility-editor.png)

1. **Add a header (optional)**

   The header appears at the top of the message. For Utility messages, keep it informational. Choose one type.
   #### Text
   Enter a short title in **Header Content** (maximum 60 characters), such as _Payment successful_ or _Order update_. You can add one variable, with a sample value.

   ![](assets/waext-v-2-utility-header-text.png)
   #### Image
   Click **Choose JPG or PNG file** and upload a sample image (maximum 5 MB).

   ![](assets/waext-v-2-utility-header-image.png)
   #### Video
   Click **Choose MP4 file** and upload a sample video (maximum 16 MB).

   ![](assets/waext-v-2-utility-header-video.png)
   #### Document
   Click **Choose PDF file** and upload a sample document (maximum 100 MB).

   ![](assets/waext-v-2-utility-header-document.png)
   #### Location
   Shows a location, with its name and address, above the message body.

   ![](assets/waext-v-2-utility-header-location.png)
   > [!NOTE]
   >
   > Media samples are only used by Meta to review your template. Do not include any customer information.
2. **Write the body**

   Enter the main message (maximum 1,032 characters). Describe the notification clearly and refer to the user's existing activity. You can format text and add variables. Provide a sample value for every variable so Meta can review the message.

   ![](assets/waext-v-2-utility-body.png)
3. **Add a footer (optional)**

   A short line at the bottom of the message, such as a disclaimer or support info. Maximum 60 characters, with no variables.

   ![](assets/sample-footer-marketing.png)
4. **Set the message validity period**

   Choose how long Meta tries to deliver the message, for example 30 days. If it isn't delivered in time, you aren't charged and the recipient doesn't see it.

   ![](assets/message-validity-period-utility.png)
5. **Add buttons (optional)**

   Buttons should help the user complete their existing action. Click **Add Button** and choose a type.
   #### Flow (commonly used)
   Opens a WhatsApp Flow.

   ![](assets/flow-button-utility.png)
   | Field               | What to enter                                                                   |
   | ------------------- | ------------------------------------------------------------------------------- |
   | **Button Title**    | The button text users see.                                                      |
   | **Flow ID**         | The ID of the flow, generated in Meta.                                          |
   | **Flow Action**     | **Navigate** opens a specific screen. **Data Exchange** sends or receives data. |
   | **Navigate Screen** | The name of the first screen of the flow.                                       |
   #### Quick Reply: Custom
   The user sends a predefined reply, such as **Yes** or **No**.

   ![](assets/quick-reply-button.png)
   #### Quick Reply: Marketing Opt-Out
   Lets users opt out of receiving marketing messages.
   #### Call to Action: Visit Website
   Opens a website. Use a **static URL** to send the same link to everyone, or select **Dynamic URL** to send a different link to each user, such as a payment link. Select **Track URL** to track clicks with [Fyno Shorty](../../url-shortener).

   ![](assets/visit-website-curousel.png)
   #### Call to Action: Call Phone Number
   ![](assets/call-phone-number.png)
   #### Call to Action: WhatsApp Voice Call
   ![](assets/whatsapp-voice-call.png)

## Step 3: Add more languages (optional)

To reach users in different regions, click **Add** next to **Languages** and add a version of the template in each language. Translate the message and button text, and keep the same variables in every language.

## Step 4: Save or send for approval

When your template is ready, save it as a draft or send it to Meta for approval. See [Save as Draft vs Send for Approval](/external-templates/whatsapp/save-or-send-for-approval).
