Create and manage labels

About labels

As an Organization Administrator, you can create labels that users can apply to applications, projects, and branches to categorize them in ways that make sense to your organization. For example, labels can represent business units, development teams, or environments. When used consistently, labels offer enhanced filtering and navigation of applications, projects, and dashboards, as well as more granular reporting capabilities.

In My Organization > Labels, you can create labels, merge or duplicate existing labels, and control whether non-Admin users have the ability to create their own labels. Once created, labels are available for users with the appropriate permissions to apply right away.

Where labels are applied

For details on where labels can be applied in the Polaris Platform, see the following articles:

Get started: Organization Application Manager — See "Create an application" and "Add a SAST & SCA project to an application".
Get started: Application Admin — See "Add a SAST & SCA project to an application".
Create and manage branches in a project — See "Add a branch to a project".

Where to filter by labels

Once applied to objects, labels are available to use as filters on the Reporting and Dashboards pages.

When creating a report or report configuration, you can filter by label when adjusting the report scope. For example, the report scope can include only branches with selected labels applied (this is not supported for SBOM reports). For more details, see Create a report and Create and manage report configurations.

On several dashboards, you can filter data by one or more application labels. Filtering dashboards by other label types is not supported. For more details, see Work with dashboards.

Note: Labels have replaced Application Tags in the Polaris UI. Tags you previously assigned to your applications were converted to labels automatically.

Work with labels

To access labels in Polaris, go to My Organization > Labels.


How to...	Steps
Create a label	Click Create Label. Enter a name and an optional description (max. 255 characters). Click Save.
Allow non-Admin users to create and apply new labels. The user's role must permit them to update application and project settings to apply labels.	Under Label Options, select the Allow new labels to be created within applications and projects checkbox.
Edit a label and view its usage across applications, projects, and branches.	Select the three-dot menu next to the label, then select Edit. Edit label details, then click Save. Usage displays a count of the applications, projects, and branches (if any) that this label is applied to. Click the link on applications to view the Portfolio page filtered by the label you are currently editing.
Duplicate a label	Select the three-dot menu next to the label, then select Duplicate. The duplicated label is created with “-1” appended to the name.
Merge labels CAUTION: Merging labels cannot be undone. Any report configurations that include merged labels in their report scope will fail to run (including on a schedule). You must update these report configurations to exclude merged labels from their scope; see Create and manage report configurations.	Select two or more labels. Click Merge Selected. In the Merge Labels dialog, enter a name and optional description for the merged label. Click Merge.
Delete a label CAUTION: Any report configurations that include a deleted label in their report scope will fail to run (including on a schedule). You must update these report configurations to exclude deleted labels from their scope; see Create and manage report configurations.	Select the three-dot menu and then select Delete. In the dialog, select DELETE LABEL.
Search for a label	Enter an alphanumeric string to search for all matching labels.