Columns and display options
How each Jira field type is shown in the Work Item Macro, its default, and the display options its column offers.
Every Jira field can be a column, shown to suit its type. The gear on a column’s row, Column options, changes how. Options belong to the column: picking another field resets them.
Options by field type
An empty field is an empty cell.
Work item and Jira fields
| Field | Shown by default | Options |
|---|---|---|
| Key | The key, linked to the work item | Link to work item (on) |
| Summary | Text | Link to work item (off) |
| Status | A lozenge, coloured by status category | Show as: Text, Lozenge |
| Status category | A lozenge | Show as: Text, Lozenge |
| Priority | Jira’s icon and the name | Show as: Icon and name, Icon only, Name only |
| Work type | Jira’s icon, with the name in a tooltip | Show as: Icon and name, Icon only, Name only |
| Project | The project name, linked | Show as: Name, Key; Link to project (on) |
| Resolution, Security level | The name | none |
| Parent | The parent’s key, linked | Show as: Key, Summary, Key and summary; Link to work item (on) |
| Subtasks | The keys, linked | Show as: Key, Summary, Key and summary; Separator; Link to work item (on) |
| Linked work items | One entry per link, such as “blocks ABC-1” | Show as: Link type and key, Keys only; Link to work item (on) |
| Labels | Tags | Show as: Joined text, Tags; Separator |
| Components, Fix versions, Affects versions | The names, joined | Show as: Joined text, Tags; Separator |
| Attachments | The number of files | Show as: Count, File names; Separator |
| Comments, Votes, Watchers | A number | none |
| Work log | The number of entries | Show as: Number of entries, Total time logged |
| Time tracking | The remaining estimate, as Jira writes it (1w 2d) |
Part: Original estimate, Remaining estimate, Time spent |
| Original estimate, Remaining estimate, Time spent | Hours and minutes (1h 30m) |
none |
| Progress | A progress bar and the percentage | Show as: Progress bar, Percentage |
People and dates
| Field | Shown by default | Options |
|---|---|---|
| Assignee, Reporter, User picker | Atlassian’s user card, with the profile picture and name | Show as: Name, User card |
| Multi user picker, People, Request participants | The users’ avatars together | Show as: Name, User card; Separator |
| Due date, Date picker, Target start and end | The date, as Sep 22, 2026 | Format: Date, Date and time, Relative (3 days ago) |
| Created, Updated, Resolved, Date time picker | The date and time, as Sep 22, 2026, 13:03 | Format: Date, Date and time, Relative (3 days ago) |
Dates use the reader’s language and time zone, 24-hour clock. A due date never shifts a day.
Custom fields
| Field | Shown by default | Options |
|---|---|---|
| Short text | Text, cut at 200 characters | Max length (0 = unlimited) |
| Paragraph, Description, Environment | Plain text, cut at 200 characters | Rich text; Max length (0 = unlimited) |
| Number, Story points | The number, formatted for the reader’s language | Decimals; Unit suffix |
| URL | The address as a link, opening in a new tab | Link text: The URL, Column heading |
| Single select, Radio buttons | Text | Show as: Text, Lozenge |
| Multi select, Checkboxes, Multi group picker, Multi version picker | The values, joined | Show as: Joined text, Tags; Separator |
| Group picker, Version picker, Team | The name | none |
| Cascading select | Parent → Child | Show: Parent, Child, Parent and child; Separator |
| Sprint | The active sprint, else the latest one | Which sprint: Active (else latest), Latest, All; Separator |
| Assets objects | Chips with icon, label and key | See Assets fields |
| Work Item Selector | Work item cards, as in Jira | See Work Item Selector fields |
- Rich text on keeps formatting and is never cut. Off, it is one line of plain text.
- A URL field links only
http,httpsandmailto; anything else is text.
Jira Service Management fields
| Field | Shown by default | Options |
|---|---|---|
| Request type | The request type name | Show as: Request type name, Portal status |
| SLA fields, such as Time to resolution | The remaining time, in a pill that turns red once the goal is breached | Show: Remaining time, Elapsed time, Goal, Breached or not |
| Organizations | The names, joined | Show as: Joined text, Tags; Separator |
An SLA pill shows running, paused, met or failed. With no ongoing cycle, it shows the last one.
Fields from other apps
Forge and Connect app fields are shown by the type they declare, with the same options as Jira’s.
An object field shows its name, title, value or key, or else its JSON. Two options pick out a part:
- Property path: a dotted path into the value, with list positions as numbers, such as
amountoritems.0.name. Empty shows the whole value. - Format: Text or JSON.
One field in several columns
Use a field in several columns with different options, such as an SLA’s remaining time and whether it is breached. Jira is asked for it once.
Limits
- A heading sort is the reader’s own and not saved. See sort by a column.
- An object field with a name ignores Property path and shows the name.
- The Separator of Subtasks has no effect. The keys are always joined the same way.
- Work item colour is a neutral lozenge with the colour’s name, not the colour.
- Exports show every column as text. See export, page history and email.