# Source: https://linear.app/docs/project-labels.md

# 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.

![Project label picker in a group](https://webassets.linear.app/images/ornj730p/production/bd6d5d4dc03f49d56d4592399c8bf278de0797e1-1402x1178.png?q=95&auto=format&dpr=2)

## 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 define project views grouped by label and filter issues themselves by their upstream project's label to get a granular understanding of work contributing towards a common area.

### Create a project label or group

Project labels and groups can be created and managed in Settings > Projects > Labels. Alternatively, create a project label directly from the label menu on a project. 

As with issue label groups, project label groups are mutually exclusive; only one sub-label per group may be applied to a project.

### 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, or issues by their project's label in issue views. 

![Projects filtered and grouped by sub-label in a group](https://webassets.linear.app/images/ornj730p/production/090809ea74d75ead6a530ca8d524151be584d917-2176x978.png?q=95&auto=format&dpr=2)

### List project label columns

When displaying a project view in a list format, you can add label groups as a display property by clicking on the Display menu and selecting the desired group. This will add a new column for that group at the list level. 

![a label group column on a project list](https://webassets.linear.app/images/ornj730p/production/e2c85e9aa8e8963cc7eb9e6a95c6ef1e919e7287-2366x932.png?q=95&auto=format&dpr=2)

<details>
<summary>Adding a project label column</summary>
![click display, list, add label group, then choose the group](https://webassets.linear.app/images/ornj730p/production/9fa22414f8bec25f56c9d07d57bdd53b5b4eaa6b-698x1288.png?q=95&auto=format&dpr=2)
</details>

### Insights

Project label is a supported property on Insights, so you can now measure issue count, issue age, or triage time on issues in aggregate sliced by the project label upstream of those issues. Please note that when using this feature you'll be running Insights on issue views rather than project views, and slicing by the project's label the issues belong to.

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

![Insights on issues by project label](https://webassets.linear.app/images/ornj730p/production/c55672fde5567ec5737efb93fa588a2ab684d9d1-1604x1413.png?q=95&auto=format&dpr=2)