Admin Onboarding - Setting up Custom Fields

Step 6a of admin onboarding — add the data each item type must carry (customer, cost centre, RICE score) as custom fields, group them into collections, and decide what shows in the sidebar versus the Forms tab.

Custom fields add your own data to items: a customer name, a cost centre, a risk rating, a RICE score. They appear in the item's right sidebar or on its Forms tab, in tables, filters, request forms, automations, and reports.

They come after item types because fields are assigned per item type, through a collection. Decide which types need which data and you are most of the way there.

How it fits together

PieceWhat it is
FieldOne piece of data with a type (text, number, date, user, and so on). Created once, reusable in many collections.
CollectionA named group of fields assigned to one or more item types. Every organization has a Default collection, which cannot be renamed or deleted.
Form groupA sub-group inside a collection. Every collection has a Sidebar group whose fields show in the item sidebar; any other group you add shows as a section on the item's Forms tab.

Open Configure Settings → Data Model → Custom Fields. The page has three panes, worked left to right.

Step 1: Create fields

Click New next to 1 - Create Fields, pick a type in Select Field Type, then fill in the Create … Field dialog (label, description, options where relevant) and save.

Field typeUse it forNotes
Text Options ListA fixed list of text choices (customers, regions)The most common type. Toggle Allow multiple selections for multi-select. Long lists can be imported from CSV.
Number Options ListA fixed list of numeric choices (RICE factors 1–10)Use when the value feeds a calculation.
Multiple CheckboxesA checklist where any number can be ticked (laptop, badge, email account)Same data as a multi-select Text Options List, shown as tick-boxes.
Short Text / ParagraphOne line / multi-line free text
Email, Phone Number, URLValidated contact data; URLs become links
Whole Number, Decimal Number, PercentNumeric entryPercent displays the number as a percentage.
Single Checkbox, SwitchTrue/falseUsable in calculations.
Date Picker, Date Time PickerDates, with or without timeA Track overdue toggle makes past dates show red with (Overdue) in tables. Off by default.
User PickerA member (accountable owner, reviewer)Can be limited to users carrying a given user label; supports multiple selections.
Asset UploadA file that belongs on every item of this type (campaign artwork)Supports multiple files.
Calculated (Number), (Text), (Date), (Boolean)A formula over other fields and item values, Excel-styleRICE and WSJF scores are the classic case. Ask Support for help with formulas.

Step 2: Group into collections

  1. Click New next to 2 - Group into Collections and name the collection (for example Product).
  2. Drag fields from the left pane into the collection's Sidebar group. Drag to reorder; drag out to remove.
  3. Tick Required on any field that must be filled before an item can be saved.

The Default collection applies to every item type you have not given its own collection. Add your organization-wide fields there.

Moving clutter off the sidebar with form groups

A collection with many fields makes a long sidebar. Click Add Forms in Collection and give the new group a Label (and optional Description); fields you drag into it appear as a section on the item's Forms tab instead of the sidebar. The Forms tab only appears when such fields exist.

The RICE example below keeps the four input factors on a RICE form group and the single Calculated (Number) score in the Sidebar group, so the sidebar shows the result and the inputs stay one tab away.

Step 3: Assign to item types

In 3 - Assign to Item Types, pick a collection for each item type (or None). Items of that type now show the collection's fields.

Everything above, plus CSV import of option values, is on Custom Fields.

Next: Setting Up Tags.