Project labels

Organize projects with custom labels relevant to your organization’s specific context. Filter projects or issues by their project’s label to clearly segment work.

Overview⁠

Project labels categorize work at scale and make it easier to filter, group, and locate projects across your workspace. While Initiatives are a great way to group projects by overarching company goal, project labels provide a more flexible and granular grouping dimension.

Use project labels to group project views and filter issues by the labels on their projects. This helps you see work contributing to a common area.

Create a project label or group⁠

In addition to workspace-level project labels, teams on Business and Enterprise plans can create team-level project labels. A team’s project labels are available on projects that include that team.

Workspace and team-level project label groups can be single-select, where you can add only one label under that group to the project, or multi-select, where more than one label under the group can be added to the project. Label groups are single-select by default.

You can update a label group to be multi-select by going to the label’s contextual menu and selecting Group type. From here you will see the option to make the label group single-select or multi-select. To view and manage your workspace-level project labels go to Settings > Projects > Labels.

You can manage team-level project labels from the team’s own settings. You can also create a new project label directly from the label menu on a project.

Using labels across teams⁠

When a project includes multiple teams, labels from each contributing team or its parent teams can be applied alongside workspace-level labels. If contributing teams have ungrouped labels with the same name, Linear presents them as one label in the picker and on the project.

Labels in different groups, including child labels with the same name, remain separate labels.

Removing teams from projects⁠

Removing a team from a project also removes that team’s project labels from the project. A matching label from another contributing team remains applied when available.

Privacy⁠

Team-level project labels follow team visibility. Labels from private teams are only visible to people who can access those teams.

Filtering and grouping⁠

Filtering projects by their label or label group allows you to organize work in units that make sense for your business and the way your work gets done.

Group projects by label or label group in project views.

List project label columns⁠

In a project list view, open Display and select a label group to show it as a column.

Adding a project label column

Insights⁠

In Insights for an issue view, use project labels to break down issue count, issue age, or triage time by the labels on each issue’s project.

Use this functionality to identify which upstream projects are driving the most work across your teams and compare performance metrics between project labels.