Skip to content
Deckbell

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

TypeWhat it holds
Single selectOne option from a list, e.g. Environment: prod, staging
Multi-selectSeveral options, e.g. Platforms: iOS, Android, Web
TextPlain text, up to 2,000 characters
NumberA number, e.g. 3 or 2.5
DateA day
MemberSomeone on the board
URLA web link (http or https)

Add a field to a board

Board settings → Custom fields
Board settings → Custom fields: Environment, Platforms, Release date, Release PR and Reviewer, each with its type and options, and Add field.

Board settings → Custom fields

  1. Open the board's Settings → Custom fields.
  2. Choose Add field, give it a name, and pick its type.
  3. 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 settings → Custom fields
Workspace settings → Custom fields: the Customer text field that every board has, with Add field, Edit and Archive.

Workspace settings → Custom fields

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

Issue → Fields
The Fields section of an issue: Environment staging, Platforms Web, iOS and Android, a release date, the release pull request link and the reviewer.

Issue → Fields

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:// or https://; 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

Custom fields → Edit
Editing the Environment field: its name, type (single select, which can’t change), description, and its options prod, staging and dev with colors, order and Archive.

Custom fields → Edit

  • 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

Board → Filter → Environment
The Filter menu after choosing the Environment field: Environment is, with prod, staging and dev to pick from.

Board → Filter → Environment

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

Board → … → Export CSV
The board’s … menu with Export CSV highlighted.

Board → … → Export CSV

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.

Still stuck? Email us and we’ll help.