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

# Variables & Message Templates

> Personalise bulk messages with per-contact variables and save reusable message templates for future broadcasts.

> [!NOTE]
>
> Message templates in Periskope are not related to WhatsApp Business API templates and do not require any prior approval.

## Variables

Variables let you personalize a bulk message for each recipient — inserting values like a contact's name, company, or any custom field into the message text. You can see exactly what each contact will receive in a live preview before you send.

### Adding Variables to a Message

**1. Navigate to the Draft Message screen**

Go to `Bulk messages > New bulk message`, select your contacts, and proceed to the Draft Message step.

**2. Add a variable**

Click the `{}` button in the message toolbar, or type `{` directly in the message body. Enter a name for the variable and a fallback value. The fallback is used for any contact where you leave the field empty.

![add-variable](https://mintcdn.com/bharatkumarramesh/QcFc_mtwjVzqh4PR/features/images/add-variable.png?fit=max\&auto=format\&n=QcFc_mtwjVzqh4PR\&q=85\&s=d6136eab9fc882e6f3dbc33eaf92cbee)

Add a Variable

![add-variable-modal](https://mintcdn.com/bharatkumarramesh/nLZLyDfnObVs3JXO/features/images/add-variable-modal.png?fit=max\&auto=format\&n=nLZLyDfnObVs3JXO\&q=85\&s=2e8ba15594c7f213453544e7cdc2e33a)

Variable Modal

**3. Insert the variable into your message**

After creating a variable, insert it by selecting it from the pop-up menu that appears when you type `{`.

![insert-variable](https://mintcdn.com/bharatkumarramesh/eWtBV2eYIgtIYxbf/features/images/insert-variable.png?fit=max\&auto=format\&n=eWtBV2eYIgtIYxbf\&q=85\&s=ff52b1c13d518c8eb3fcdee2e3bff19b)

Insert Variable

**4. Fill in variable values for each contact**

Click `Next Step` to open the Fill Variables screen. Each contact appears as a row in the table — fill in variable values directly.

![fill-variables](https://mintcdn.com/bharatkumarramesh/hz7lf2Fm42TCjPEk/features/images/fill-variables.png?fit=max\&auto=format\&n=hz7lf2Fm42TCjPEk\&q=85\&s=050b6775d13e348f7af0e33e3c3b3416)

Fill Variables

You can also fill values using a CSV. Download the CSV from the top right corner, fill in values using Google Sheets or Excel, then upload it back.

![edit-csv](https://mintcdn.com/bharatkumarramesh/IzTgyiP5udfKpAu_/features/images/edit-csv.png?fit=max\&auto=format\&n=IzTgyiP5udfKpAu_\&q=85\&s=3c1a9dcc381f5e5a1275f65227f98e62)

Edit CSV File

> [!WARNING]
>
> Do not modify the columns or add/remove rows in the downloaded CSV. If you need to add variables or chats, make those changes in the table first and download a new CSV.

[/features/images/upload-variable.mp4](https://docs.periskope.app/features/images/upload-variable.mp4)

Upload CSV

**5. Preview the messages before sending**

Click through each contact in the preview panel to see exactly how the final message will look for that recipient, with all variables replaced by their actual values.

![preview-variables](https://mintcdn.com/bharatkumarramesh/hz7lf2Fm42TCjPEk/features/images/preview-variables.png?fit=max\&auto=format\&n=hz7lf2Fm42TCjPEk\&q=85\&s=b73711c117d6c0277041bfd4d5bdcb2d)

Preview Variables

**6. Choose a delivery mode and send**

Once happy with the preview, choose a delivery mode and send. See [Sending a Bulk Message](https://docs.periskope.app/features/bulk-message.md) for delivery options.

***

## Message Templates

Message templates let you save a drafted message — including variables and attachments — and load it instantly in any future broadcast.

### Saving a Template

**1. Draft a message**

Write your message in the Draft Message section. You can include text, variables, images, videos, and other attachments.

**2. Click Save template**

Click the `Save template` button at the top of the Draft Message screen.

**3. Choose a template name**

Enter a descriptive name so you can identify it easily later.

![save-template](https://mintcdn.com/bharatkumarramesh/IzTgyiP5udfKpAu_/features/images/save-template.png?fit=max\&auto=format\&n=IzTgyiP5udfKpAu_\&q=85\&s=5559c01f69d4dd8d861a7cf539477fbc)

Save Template

### Using a Template

When drafting a new broadcast, click the template picker to load a previously saved message. The message content, variables, and any attachments will be pre-filled.

### Duplicating a Template

You can duplicate an existing template from the template list to create a variation without modifying the original.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.