Labels

Organize dashboard content by grouping and filtering

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

Edit a Label for a single item

To edit a label for a single item, 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.

Edit a Label universally

  1. Select "Add Filter"
  2. Select "Label"
  3. Select a specific label
  4. Select "Label"
  5. Select the "Manage Labels" dropdown on the top right corner of the page
  6. Select "Rename Labels"
  7. Update the existing label's name and click "Rename"

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 for teams thinking about how to use labels strategically:

  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. Ensure stakeholders and cross-functional partners are aligned
  5. Apply the labels in your OneSignal dashboard. 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.