Docs / Configure

Custom Fields

Define extra fields (text, number, date, yes/no, select, multi-select) for features, epics and stories. People fill them in on the Backlog, and a required field must be filled in when an item is created.

When to use it

When you want to set up the extra field types your team uses at each backlog level.

Start here

Click "+ Add Field" and choose which level it applies to. Then fill the values in from the item's dialog in the Backlog.

How to use it

  1. Open the tab and look at the three sections, Features, Epics and Stories. Each shows how many fields are defined and lists them with Name, Key, Type, Required, Options and Sort columns.
  2. Click "+ Add Field" to open the "New Custom Field" form.
  3. Enter a "Field Name", then choose the "Entity Type" (Feature, Epic or Story) the field belongs to.
  4. Choose a "Field Type": Text, Number, Date, Boolean (Yes/No), Select (single) or Multi-select.
  5. For Select and Multi-select, fill in "Options" as a comma-separated list, for example Low, Medium, High, Critical. Options must be unique, with at most 50 of up to 100 characters each.
  6. Optionally set a "Sort Order" number and switch on "Required field", then click "Create Field". Use "Edit" on a row to change the name, required switch, options or sort order, and "Delete" to remove a field.
  7. Fill the values in on the Backlog. Open or add a feature, epic or story: its dialog ends with a "Custom fields" section with one input per field, and a red asterisk marks a required one.
  8. After saving, an item's row in the Backlog shows up to three of its non-empty values as small chips.

Good to know

  • Required applies when you create an item in the Backlog: it cannot be created with the field empty. Existing items are not blocked, and editing other details of an item never fails because of an empty required field.
  • Only clearing a required value that is already filled in is refused. Items made by Excel import, AI generation or other integrations are not checked against Required.
  • When editing, the key and the field type are shown but cannot be changed. Deleting a field also permanently removes all values stored for that field.
  • A Select value must be one of the options, a Date uses the format YYYY-MM-DD, and text is limited to 2000 characters.
  • Anyone on the project can read the values; changing them needs permission to edit the backlog.

Related

Last updated 6 October 2026