There are two main types of lists in Iterable:
Static - A static list is a set of specific contacts that you add or upload yourself (or that contacts are added to when they fill out a sign-up form).
Dynamic - Dynamic lists use segmentation to select and automatically update groups of contacts based on shared attributes. For example, a dynamic list might search for people who have opened or clicked an email in the past 90 days.
Table of contents
Viewing your project's lists
The list index page is where you can view your lists, import new lists, filter by list type, export a list of unsubscribed users by channel, add or remove subscribers from a channel, and delete lists.
To view your project's lists, navigate to Audience > Lists:
Viewing dynamic list size
When you visit the list index page, the dynamic list sizes shown in the Contacts column update once per hour. This means the list index page might not show a dynamic list's real-time size. When you or another member access the list index page again, given an hour or more has passed, the Contacts column shows the list's actual size.
You can always click into a dynamic list to see its contacts in real time, or check the list index page again after an hour.
NOTES
Your dynamic lists always include all the users who match the defining segmentation query, even if the list size hasn't updated yet. When you send a campaign to a dynamic list, the campaign is sent to all the users who match that list's segmentation criteria at send time.
The displayed list sizes update in each of your projects separately, depending on when you access Audience > Lists in the project.
If you have multiple pages of dynamic lists, each page updates independently based on when you click the page.
Creating a static list
To create a static list:
-
Navigate to Audience > Lists, click Import List, and upload a CSV file of subscribers (or enter some contacts in the text input).
-
Alternatively, navigate to Audience > Segmentation and set up a segmentation query to select contacts that are already in your project. After building your query, save the list by selecting Save List > Save as a New Static List(s).
This brings up the Save Users from Query into New List window, where you can specify where Iterable should save the query's results.
Or, create a list with the
POST /api/lists
API and add contacts to it with thePOST /api/lists/subscribe
API.
TIPS
- To add users to a journey when they join a static list, select the List subscribe entry source in the journey's Start tile.
- When you use the segmentation tool to create a static list, there is a list
size limit of 5 million contacts. You can also use the list feature to create a list
or use the
POST /api/lists/subscribe
API.
Suppression lists and internal lists
Suppression lists and internal lists are special types of static lists.
Suppression lists
Suppression lists exclude contacts from blast campaigns. They cannot be used as send lists.
IMPORTANT
Adding a contact to a suppression list does not prevent Iterable from sending all blast campaigns to that contact. Suppression lists only prevent contacts from receiving the specific campaigns that the suppression list is applied to.
Internal lists
You can use internal lists to send proofs of messages to your teammates without worrying about accidentally sending them to your customers. This can be helpful for reviewing and testing campaigns before you're ready to send them.
Creating a dynamic list
To create a dynamic list, navigate to Audience > Segmentation and set up a segmentation query. After building your query, click Save List > Save as a New Dynamic List to create the list.
When you send a campaign to a dynamic list, Iterable selects all of the contacts who match the segmentation query at send time.
To learn more about lists and segmentation, see:
Comments
0 comments
Please sign in to leave a comment.