Articles in this section

See more

Working with Labels

Labels let you tag and organize campaigns and journeys in an Iterable project.

# In this article

# Managing your project's labels

NOTE

To manage a project's labels, you'll need the Manage Settings permission.

You can view and manage your project's labels from your Project Settings page.

Managing labels

From here, you can:

  • Create new labels
  • Edit existing labels
  • Delete labels

# Creating a label

To create a new label for your project, click Create a New Label. In the menu that opens, enter a name for your new label, and click OK.

Label names must be unique. (You can't create two labels with the same name.)

# Editing a label

To edit a label, click Edit under the Actions column. Make your desired changes, then click OK.

When you edit the name of a label, the label name is updated in all of the campaigns and journeys where it's used.

# Deleting a label

To delete a label, click the trash can icon in the Actions column, then click Yes to confirm.

WARNING

Deleting a label from your Project Settings page also removes the label from every campaign and journey it's attached to. Keep this in mind when deleting labels from your project — once a label is deleted, you won't be able to filter campaigns and journeys by that label anymore.

# Adding labels to campaigns and journeys

You can add labels to new and existing campaigns and journeys by clicking the Add Label button on the campaign or journey's details page.

The Add Label button

To edit the labels in a campaign or journey, click the pencil icon next to the labels section and make your desired changes.

Selecting labels

NOTE

A copy of a campaign or journey will have the same labels as the original. However, if you add or remove any labels from the copy, the original won't be affected.

# Searching for content by label

To find all the campaigns or journeys with a particular label, go to the Campaigns or Journeys page and click Filters > Label. Then select one or more labels from the dropdown.

Filtering by label

# Exporting labels

You can use the following API endpoint to fetch metadata (including labels) for your campaigns:

This endpoint returns data like this:

{
  "campaigns": [
    {
      "id": 1611189,
      "createdAt": 1602627617382,
      "updatedAt": 1602627690330,
      "startAt": 1602627690330,
      "endedAt": 1602627690497,
      "name": "Fall sale",
      "templateId": 2225431,
      "messageMedium": "Email",
      "createdByUserId": "user@example.com",
      "campaignState": "Finished",
      "listIds": [657633],
      "suppressionListIds": [],
      "sendSize": 23431,
      "labels": ["seasonal-sale"],
      "type": "Blast"
    }
  ]
}

NOTE

The GET /api/journeys endpoint does not currently return the labels associated with a journey.

Related articles