Labels

Group and organize dashboard content

Create a label on the Push, Email and Templates Index page to group messages and templates for a more organized dashboard experience. Once something has a label, a filter can be applied to only display items with that label.

New labels column on the Push Index.

New labels column on the Push Index.

Adding a Label

Up to 5 labels can be added to each index item. Each label can have up to 100 characters, and each label must be unique. A Label can be used across different channels.

To add a label, navigate to the three dots on the right side of the index page. Select "Add Labels" on a line item with existing labels to launch a pop-up where you can add labels.

Click "Create" in the dropdown to create a new label. Click "Update" to add the label to the message.

Click "Create" in the dropdown to create a new label. Click "Update" to add the label to the message.

Suggested use cases for organizing messages with labels:

  • Team
  • Message creator
  • Detailed statuses
  • Topic
  • Purpose or Objective
  • Geography
  • Event
  • Language
  • Message type
  • Top Performers

Editing a Label

To edit a label, navigate to the three dots on the right side of the index page. Select "Edit Labels" on a line item with existing labels to launch a pop-up where you can view, remove, or add all associated labels.

Edit labels for each index item through the options menu.

Edit labels for each index item through the options menu.

Filtering on Labels

Up to five labels can be applied to an index at once. The filter supports an AND operator only. For example: If you filter by Label A and Label B, all results will have both of these labels.

Use the filter to find items with that label applied. Limit 5.

Use the filter to find items with that label applied. Limit 5.

Best Practices

Here are the recommended steps on how to think about labels before getting started:

  1. Create standards for when it makes sense to add a label
  2. Agree on naming conventions
  3. Plan ahead, brainstorm, and map out the labels you want to use
  4. Make sure your stakeholders and cross-functional partners are aligned
  5. Apply the labels in your OneSignal dashboard
  6. Iterate and adjust as needed

FAQ

If I have the same label on different indices, would that group items from multiple lists together?

Yes, labels are not page-specific. For example, the label "Superbowl 2023" on the Push Notifications index can be used on another index as well.