Developer DocsSign in

Project Labels Business ​

Project labels let you categorize projects across your workspace by team, function, priority, or any custom classification. Labels are defined at the workspace level and can be applied to any project. A project can have multiple labels.

Labels organize projects. They don't change who can access a project or what anyone can do in it; roles and project visibility handle that. Project labels are separate from the labels on work items, which belong to one project.

Project labels sit alongside project states, and the Labels property shows on a project only when project states are turned on for the workspace.

Create project labels ​

  1. Go to Workspace Settings → Projects.
  2. Click the Project labels tab.
  3. Click Add label.
  4. Enter a label title and choose a color. The title is required and can be up to 255 characters.
  5. Click Add.

Project labels tab in the workspace's Projects settings, listing Customer-facing, Core product, Internal, Revenue and Experiment, with an Add label button

Label titles must be unique in the workspace. If one already exists, Plane says "Label with this name already exists". Before you create any, the tab reads "No labels yet" and "Create labels to group and filter projects across this workspace."

You can also create labels directly from the label picker when assigning them to a project.

Apply labels to a project ​

Only project admins can change a project's labels.

  • When you create a project, pick labels in the Labels field on the create form.
  • On an existing project, open its Overview page and set Labels in the Properties tab. See Project Overview.

Each label shows as a chip on the project's card on the Projects page.

Group projects by labels ​

In Board and List layouts, you can group projects by their labels:

  • Each label appears as its own column or group.
  • Projects appear under their assigned labels.
  • Projects without labels appear in a No Label group.

Projects page in the List layout grouped by label: Customer-facing with Web Platform and Mobile App, Core product with Mobile App, an empty Internal group, Revenue with Growth Experiments and Web Platform, Experiment with Growth Experiments, and Design System in the No Label group

This makes it easier to scan and manage projects by custom categories.

Edit and delete labels ​

Edit a label:

  1. Go to Workspace Settings → Projects → Project labels.
  2. Click the … icon on the label and select Edit label.
  3. Update the name or color and click Update.

Delete a label:

  1. Click the … icon on the label and select Delete.

WARNING

Deleting a label removes it from all projects that had it assigned.

See also ​