Recipient lists

To create a new recipient list or change properties and data fields of existing recipient lists, contact customer support.

The Recipient list menu provides functions to edit, empty, or copy recipient lists. The overview area shows recipient lists for your client, and the number of recipients in each list.

Copying a recipient list

Creates a new recipient list that contains the same data fields as the selected source list. Only the list structure is copied, not the entries.

Editing a recipient list

Change the name or description of a list. You can also set any recipient list as a test list. Use test lists only for sending test emails, not regular sending.

Do not use real customer data for test lists, but use your own data or that of your co-workers and superiors, for example.

Clearing a recipient list

Deletes entries from a recipient list. The list itself is not deleted and can be used again.

To delete and/or unsubscribe multiple recipients from multiple recipient lists, use Cleanup.

Displaying recipient list details

If Separate data storage is activated in your clientThe working environment of Episerver Campaign. A client is a stand-alone and closed system that serves to organize your mailings. Campaign users can use one or more clients for your scenario., you can use Details to access the settings to hide or display recipient list fields with personal data for users of your client.

  1. Click Details. The Show recipient list details opens.
  2. In the list, select the recipient list field you want to hide or display for users of your client.
  3. Click Edit. In the Shown data column, a drop-down list opens.
  4. In the drop-down list, select:
    • Master data. Display the recipient list field only to users with appropriate permissions.
    • Properties. Display the recipient list field to all users.
  5. Click Submit.
  6. If necessary, repeat these steps for additional recipient list fields.
  7. To save the changes for recipient lists, click Apply changes to all lists. To save the changes only for the selected recipient list, click Apply changes.

Separate data storage supports three user permissions for displaying personal recipient data:

  • View Properties fields only
  • View Master data fields and Propertiesfield separately (so a user cannot associate properties with a recipient)
  • View Master data and Properties fields

For details about Separate data storage and individual user permissions, contact customer support.

Recipient list data fields

Every recipient list contains an unlimited number of data fields. One data field is reserved for the recipient ID, usually the email address. You cannot edit the recipient ID field. Instead of the email address, you can use any other ID, such as a customer ID.

Recipient list data types

Each data field can store a certain data type, which is selected when the recipient list is created. According to the data type, you can perform mathematical and/or logical operations with the value of a data field. For example:

  • Numbered fields. Numbers can be integers (32-bit/64-bit) or floating decimals. Compare the value of a field with a given value (equals/is less than/is greater than).
  • Date fields. Compares date and time (is older than/is younger than/is prior a given time/date/is past a given time/date/is exactly ... old).
  • Boolean fields. Perform is true or is false operations.
  • String fields. Congruity or incongruity of strings and characters (begins with, end with, does not begin with, does not end with, contains, does not contain).

The following data types and range of values are permitted for recipient list data fields:

Data type Range Example
Boolean true/false Registration via website, interested in promotional newsletters
Date date

Registration date. Supported date formats:

Programming interfaces (APIs) only support date formats according to ISO 8601.

Date format Description Example
yyyy-MM-dd Date with separator 2017-05-07
yyyy-MM-dd HH:mm:ss Date and time 2017-05-23 09:50:04
yyyy-MM-dd'T'HH:mm:ss Date and time according to ISO 8601 2017-05-23T09:50:04
yyyy-MM-dd'T'HH:mm:ss,SSS Date and time with milliseconds 2017-05-24T08:03:59,123
yyyy-MM-dd'T'HH:mm:ssXXX Date and time with time zone offset 2017-05-07T12:18:54+02:00 2017-05-07T08:18:54-02:00
Float single-precision 32-bit IEEE 754 floating point Conversion volume, customer score
Integer 32-bit-signed; -2,147,483,648 - 2,147,483,647 Age
Long 64-bit-signed; -9,223,372,036,854,775,808 - 9,223,372,036,854,775,807 Customer ID
String unicode text up to 256 characters Email address, first name, last name, city, postal code
Text up to 64,000 characters Email address, first name, last name, city, postal code