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, choose the labels that you wish to apply to the campaign. The dropdown will automatically suggest existing labels.
You cannot create new labels under this section. You will need to create them in Project > Settings before they appear here (see the Managing Labels section below). If no labels exist in your project, the drop-down menu 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.
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 in 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.
Use the the
endpoint to fetch campaign metadata, including labels.
Labels are also included as a JSON array when exporting campaigns to CSV from the UI.
Campaign labels must be in the format <key>:<value>.