Custom fields
Workspace fields for what the model doesn't ship with: client, amount, delivery date…
Custom fields cover what the model doesn’t ship with: client, amount, delivery date, invoiced… You define them once for the workspace and fill them in on any task.
They live in Settings → Custom fields; creating and deleting them is for admins.
Types
| Type | What for |
|---|---|
| Text | A free value (client, external reference…) |
| Number | Amounts, quantities |
| Date | Committed delivery, invoicing date… |
| Checkbox | Yes/no (invoiced, reviewed…) |
| Member | Someone in the workspace other than the assignee |
The type can’t be changed once the field exists: if you got it wrong, archive it and create another.
How they’re used
- They appear on each task under Custom fields, filled in and cleared right there.
- They’re reordered by dragging, both in settings and on the issue itself.
- They can be shown as a column in the issue list, and grouped by.
- Archiving ≠ deleting: archiving stops offering it on new tasks but keeps the values already written; deleting removes the field and its value on every task. The app tells you how many before you confirm.
Plan limit
Free includes 3 active fields (archived ones don’t count). Paid plans have no limit. See Billing & plans.
From an agent
An agent connected over MCP discovers them with
list_custom_fields and fills them in by passing customFields to save_issue.
Related: Issues · API & MCP · Billing & plans.