In Iterable, you can use labels to organize and filter campaigns.
Labeling a Campaign
To label a campaign, navigate to Step 1 or the Setup page of the campaign creation process. Under Labels, you can choose the labels that you wish to apply to the campaign. The dropdown will automatically suggest existing labels.
Note: You cannot create new labels under this section. You will need to create them in Project Settings before they appear here (see Managing Labels section below). If no labels exist within your project, the dropdown field will be absent.
If a campaign is still in a draft or ready state, you can re-label it by returning to the Setup page. You can add, remove, or reorder existing labels here. To change the order of the labels, move them around in the select box.
For finished or running campaigns, you can view labels by navigating to the campaign analytics page. Similar to the Setup page of the campaign creation process, the labels area of the campaign analytics page allows you to add, remove, or reorder labels.
If the campaign has not yet been labeled, a placeholder will be displayed.
Note: Whenever campaigns are cloned, labels are automatically copied over to the cloned campaign from the master campaign, including ones created by recurring campaigns. Label changes made to the master or parent campaigns are not applied to their cloned or already existing child campaigns.
You can view and search for labels through the campaigns table, which can be found in the All Campaigns page and in the Aggregate Campaign Analytics page.
Labels that match the search text will automatically be highlighted and displayed first in the campaigns table. As with other searches within Iterable, searching labels is not case-insensitive and partial matches work.
By default, the list of labels for each campaign is limited to one line to save space. Users can click on the labels to expand and to collapse again.
You can manage labels by going to Settings > Project. Here you can create a new label, edit a label name and delete a label.
Label names must be unique. Creating or renaming a label with the same name as an existing label name will result in an error, even if you change the case.
Campaign metadata from the
GET /api/campaigns API endpoint includes the labels for each campaign.
Labels are also included when exporting campaigns to CSV from the UI.
Labels are included as a JSON array in the exported CSV.
Key Value Pairs
For campaign labels, we use the format <key>:<value>. Labels must be in this format, as we plan on making use of the key value pairs in the future for foldering, segmentation, and other features.