How to Create Custom Variables

In addition to the standard variables that are available in the SendPulse service, you can add custom variables. There are two ways to do this:

• create variables in a mailing list;
• add variables while uploading a file with contacts and additional data for them.

How to Create a Custom Variable in a Mailing List

Open a mailing list where you want to add a variable. Click the "Create variable" button.

In the "Create variable" window, specify a name and select a type of the variable.

Select the "Available for editing by the subscriber" checkbox if you want to provide subscribers with an opportunity to edit their data.

Click "Add" to save the variable.

The type of the variable depends on the kind of information that will be transmitted in the variable:

• String passes a text value, for example, a subscriber's name, a company name.
• Number passes a numerical value, such as a phone number.
• Date passes a numerical value, for example, a date of birth, a date of registration.

For the {{date}} variable to display correctly in the service, use one of the following date formats:

YYYY/MM/DD, YYYY/M/D, YYYY/M/DD, YYYY/MM/D.

Dates entered as 01/01/2019 are processed as MM/DD/YYYY.

How to Add Variables While Uploading a File with Contacts

Open a mailing list where you want to add a variable. Click "Add contacts."

In the "Upload file" tab, choose a file with contacts, and click "Upload." Supported file formats are TXT, CSV, XLS, XLSX.

In the next step, add a variable for each column with additional data from the file: above a column, click "Disabled" and add a variable from the drop-down list or create a new variable.

Click "Add" to upload the contacts from the file to the service.

After the contacts are uploaded into the mailing list, all the variables that you enabled during the upload will be displayed in additional columns.

You can edit the names of variables or delete custom variables. Hover over a name of a variable with a mouse pointer and click the pencil icon to edit the variable name or click the bin icon to delete the variable.

How to Edit Variable Values

To edit a value of one variable for a single contact, click this value and make changes. Save the updated value by pressing the "Enter" button or by clicking the "Change variable value" button.

It is possible to update the values ​​of several variables for one contact by API.

To update variable values ​​for several contacts at once, upload a file with the list of contacts and updated data to the service. Select the "Update variable values ​​for existing contacts" checkbox and click "Add."

How to Add Custom Variables to an Email Template

You can create your email template in the layout template editor or an HTML editor, or import a ready-made template. To add a variable to any of these templates, enter it in double curly braces, for example {{name}}, in the right place in the template.

ATTENTION! For data from variables to be added to emails, variable names must completely match in mailing lists and templates. If you specify a variable name with a capital letter in a mailing list, for example {{Name}}, then enter this variable with a capital letter in templates.

To add variables to a template while creating a campaign, select an email template and proceed to edit it. Place the cursor in the place where you want to add a variable and click the "Variables" button.

Select a variable from a drop-down list. The standard variables and all the variables from the mailing lists that you choose for this campaign are available in the drop-down list.

Use smart personalization in emails to increase the efficiency of email campaigns.

Last Updated: 2020-01-21