Create custom fields

Add custom fields to track project-specific metadata on issues.

Create a custom field

1. Go to Settings > Custom Fields
2. Click + New Custom Field
3. Enter:
   • Field name — What you’re tracking
   • Field type — Text, Number, Dropdown, etc.
   • Description (optional) — How to use this field
4. Click Create

The field is now available on all issues in the project.

Custom field types

Type	Usage	Example
Text	Short text	“Browser compatibility issue”
Number	Numeric value	“Performance: 500ms”
Dropdown	Single choice	“Risk level: Low, Medium, High”
Multi-select	Multiple choices	“Affected platforms: iOS, Android, Web”
Date	Calendar date	“Launch date: 2026-03-15”
Checkbox	Yes/no toggle	“Requires documentation: Yes”
URL	Link	“Related PR: https://…”

Make a field required

1. Go to Settings > Custom Fields
2. Click the field
3. Toggle Required to on
4. Click Save

People must fill in this field when creating an issue.

Set default values

For some field types:

1. Go to Settings > Custom Fields
2. Click the field
3. Set a Default value
4. Click Save

New issues auto-populate this field with the default.

Edit a custom field

1. Go to Settings > Custom Fields
2. Click the field
3. Edit name, type, or description
4. Click Save

Changes apply to all issues using this field.

Delete a custom field

1. Go to Settings > Custom Fields
2. Find the field
3. Click Delete
4. Confirm

Data in this field is lost on all issues.

Use custom fields on issues

1. Click an issue to open it
2. Find the custom field in the detail panel
3. Enter or select a value
4. Click Save

Filter by custom field

Issues filter to show only those with that value

Go to Board or Backlog

Click Filters > Custom Fields

Select a field and value