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 and projects, and 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", "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".

Labels are also available to use with reports. Users can filter by label when adjusting the scope of a report; for example, to include only branches that have selected labels applied (this is not supported for SBOM reports). For more details, see Create a report and Create and manage report configurations.

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.	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: Remember to update any report configurations that use the deleted label.	Select the three-dot menu and then select Delete. In the dialog, select Delete.
Search for a label	Enter an alphanumeric string to search for all matching labels.