Skip to main content
Categories and Labels

Learn about categories and how to use them with announcements and roadmaps.

Michael Simmons avatar
Written by Michael Simmons
Updated this week

What are categories?

Categories are tags you can create and apply to each LaunchNotes announcement and roadmap item. Adding categories helps you organize and segment your announcements and roadmap items. They provide granularity to anyone interested in subscribing to receive updates on a specific category on your LaunchNotes page that may be of interest to them.

Categories are completely customizable and are designed to map to the needs of any business or org structure. When you create your announcement, you can associate one or multiple categories to it, based on the work it will impact.

What are labels?

Labels are optional tags that you can create an apply similarly to categories. They work alongside categories to help you communicate other information such as the type of change (New feature, Fix, Improvement). Labels are not available on all plans.

Unlike categories, labels are not associated with subscriptions or audience segmentation. Labels are displayed on the published page and in notifications alongside categories.

Labels can be used to filter announcements and roadmap items on your audience page, giving visitors to your page a way to find the changes that are important to them faster than ever.

Managing Categories

At least 1 category is required to be able to send notifications with LaunchNotes. This section will cover how to create, update, and delete categories, as well as how to associate categories with your announcements and roadmap items.

Creating a new category

Categories can be created, updated, and modified under the Settings > Categorization > Categories tab in the management portal.

Here, you can set the following:

  • Category name (required): This is what appears on your LaunchNotes page.

  • Category description: This is an internal description only, it is not visible on your LaunchNotes page.

  • Category color: You can use colors to organize or group categories with similar characteristics.

Category API slug and ID

When each category is created, it is also assigned an API slug based on its name and a unique ID. This slug is what is referenced when using categories via the API (such as when creating different views with the Embed).

Adding categories to announcements

You can associate categories with an announcement when you draft a new announcement.

You then have the option to notify subscribers of the categories you selected.

Adding categories to roadmap items

When you create a new roadmap item, you have the option to include which categories it is related to.

Removing categories from announcements and roadmap items

Removing categories from an announcement or roadmap item is simple.

Removing categories from an announcement

To remove a category from an announcement, navigate to the announcement in the admin portal and go to the Update content & settings section. From there, you can remove individual categories from the announcement and click Update to save your changes.

Removing categories from a roadmap item

To remove a category from a roadmap item, navigate to the roadmap item in the admin portal and remove the category. This page auto-saves as you make changes.

Managing Labels

Labels and label filters will only display if your page has at least 1 label associated with it. This section will cover how to create, update, and delete labels.

Creating, updating, and deleting labels

Labels can be created, updated, and modified under the Settings > Categorization > Labels tab in the management portal.

Here, you can create a new label and set the following:

  • Label name (required): This is what appears on your LaunchNotes page.

  • Label color: Colors are not displayed by default, but can be accessed via the API for custom implementations

You can also use the three dot menu at the right of each label to update or delete them.

Label API slug

When each label is created, it is also assigned an API slug based on its name and a unique ID. The slug and ID are relevant for API calls.

Did this answer your question?