Skip to main content

​
Adding Bulk Message Variables

Variables allow you to 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 value each contact will receive, with a live preview before you send.
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 value is used for any contact where you leave the field empty.
add-variable

Add a Variable

add-variable-modal

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

Insert Variable

4

Fill in variable values for each contact

Click Next Step to go to the Fill Variables screen. Each contact is shown as a row in the table. Fill in the variable values for each contact directly in the table.
fill-variables

Fill Variables

You can also fill variable values using a CSV. Download the CSV file from the top right corner of the screen.Fill in the variable values for each chat using a CSV editor like Google Sheets or Excel.
edit-csv

Edit CSV File

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 and then download a new CSV file.
Upload the modified CSV to Periskope by clicking the Upload Variables button. You will notice the table has been populated with the values that you provided. Once you have verified all the variable values, click on Preview & Send.

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

Preview Variables

6

Choose a delivery mode and send

Once you are happy with the preview, choose a delivery mode:
  • Send now — sends immediately
  • Schedule once — sends at a specific date and time
  • Schedule repeating broadcasts — sends automatically on a recurring cadence