About issue fields in projects

Issue fields are organization-level fields that provide consistent, typed metadata across all repositories. Unlike project custom fields, issue fields are defined once at the organization level and are available on every issue and in every project across the organization. For more information on creating and managing issue fields, see Managing issue fields in your organization.

Adding an issue field to a project

To display issue field values in a project:

1. Open a project and select a view using the table layout.
2. Click in the table header.
3. Click Add field.
4. Select one or more issue fields from the list of available fields in the organization.
5. Click Add.

The issue field appears as a column in the table view.

Removing an issue field from a project

To remove an issue field from a project:

1. Click in the top right corner of the project page.
2. Click Settings.
3. In the left sidebar, select the issue field you want to remove.
4. Click Remove field.

Removing an issue field from a project does not delete the field or its values from the organization. The field can be re-added at any time.

Editing issue field values in a project

You can edit issue field values directly in the project table view without opening the issue. Click on a cell in the issue field column to set or change the value. Changes are synced back to the issue automatically.

Grouping, filtering, and sorting

You can group, filter, and sort project views by issue field values, just like any other project field. This works in both table and board layouts.

You can also use issue fields to group by column on the board layout.

Charts and insights

Issue fields are available as data sources in project charts. You can create charts that group or segment by issue field values to visualize trends across your organization.

Limits

Projects support up to 50 fields in total. Issue fields and system fields count toward this limit. If a project is already at the field limit, you need to remove existing fields before issue fields can be added.