Projects & issues
Custom fields
Add your own fields to issues, such as Environment, Release date or Release PR, and filter the board by them.
Custom fields let you track what your team needs on every issue, such as the environment a bug is in, the release it ships in, or a link to the release pull request.
Field types
| Type | What it holds |
|---|---|
| Single select | One option from a list, e.g. Environment: prod, staging |
| Multi-select | Several options, e.g. Platforms: iOS, Android, Web |
| Text | Plain text, up to 2,000 characters |
| Number | A number, e.g. 3 or 2.5 |
| Date | A day |
| Member | Someone on the board |
| URL | A web link (http or https) |
Add a field to a board
- Open the board's Settings → Custom fields.
- Choose Add field, give it a name, and pick its type.
- For a select, add its options and pick a color for each.
Board admins and members with the Customize permission can manage a board's fields. Everyone else sees the list without changing it. A board can have up to 30 active fields.
The type can't change after the field is made. To use another type, make a new field.
Fields for the whole workspace
Workspace owners and admins can add fields that every board gets, such as Customer, in Workspace settings → Custom fields. Workspace fields appear on all boards, before the board's own fields, and a board's settings list them without changing them. A board can't have its own field with the same name as a workspace field. A workspace can have up to 30 workspace fields.
Fill in fields on an issue
Open an issue. Its fields are in the sidebar under Fields; an empty one says Empty. Choose a value to change it, and Clear to remove it. Every change shows in the issue's activity, e.g. "changed Environment from staging to prod".
- Member fields only take people who can see the board.
- URL fields only take links that start with
http://orhttps://; anything else is refused, and the field says why. The arrow next to a link opens it in a new tab. - Text is shown as plain text, line breaks included.
The Android, iOS, macOS and Windows apps show and edit field values too.
Change or archive options and fields
- Rename an option, change its color, or move it up or down the list. Issues keep their value.
- Archive an option you no longer use. Issues that have it keep it, dimmed, but it can't be picked again. Restore brings it back.
- Archive a field to hide it from issues and filters. Its values are kept, and Restore in the Archived list brings the field back with them.
Filter by a field
On the board, open Filter and pick a field under Fields, then choose what to match:
- an option or a person (or several);
- a number range;
- dates before, on or after a day;
- text that contains some words;
- or whether the field is empty.
Save the filter as a view to keep it.
Export
Export CSV in the board's … menu downloads its issues with a column for each field. The workspace export includes all fields and their values.
For AI tools and the API
AI tools (MCP) and the REST API can read, set and filter custom fields. See AI tools (MCP) and the REST API.