Columns and display options
Every Jira field on the site can be a column. The macro recognises the field’s type and shows it the way that type reads best, and the gear on the column’s row, Column options, changes how. The gear appears only for field types that have options.
Options belong to the column, not the field. Picking another field for a column resets its options, and a column saves only the options that differ from the default.
Options by field type
Defaults are shown before any option is changed.
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, Work type | Jira’s icon and the name | 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; 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 | A user card with avatar | 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 are in the reader’s Atlassian profile language and time zone, with a 24-hour clock. A calendar date, such as a due date, never moves to the day before or after with the time zone.
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 |
With Rich text on, a paragraph field keeps its formatting, lists and links, and is never cut. Off, it is one line of plain text.
A URL field links only http, https and mailto addresses. Anything else is shown as 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 whether its clock is running, paused, met or failed. With no ongoing cycle, it shows the last completed one.
Fields from other apps
Fields added by Forge and Connect apps are shown by the type they declare: text, number, user, group, date or a list of them, with the same options as the Jira fields of that type.
A field that holds an object shows its display name, name, title, value or key, whichever it has, and its whole value as JSON when it has none. Two options pick out one part of it:
- 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
A field can be used in any number of columns, each with its own options: an SLA shown once as remaining time and once as breached or not, or an Assets field shown once by label and once by an attribute. Jira is asked for the field once, whatever the number of columns.
Limits
- No column sorts. The order is the JQL query’s
ORDER BY. - An object field from another app may ignore Property path. When its value has a name, the page shows the name, even though the configuration offered the option.
- 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 with the same options, as text: icons, avatars and progress bars become words and numbers. See export, page history and email.