Wiki source code of JIRA Issue Fields
Last modified by Vincent Massol on 2026/07/27 21:23
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | The ##fields## parameter of the ##jira## Macro lists the issue fields to display, in display order, separated by commas. Each entry has the form ##id:label!type##, in which only the id is mandatory. | ||
| 2 | |||
| 3 | |=Part|=Mandatory|=Description | ||
| 4 | |##id##|Yes|The field to display. Use one of the standard ids below, or the display name of a custom JIRA field. The special id ##note## displays the text written after an issue key in the Macro content when the ##list## source is used. | ||
| 5 | |##label##|No|The column header used by the ##table## style. Wrap it in single quotes when it contains spaces. This is the replacement for the deprecated ##fieldNames## parameter, and it is also the way to translate a header. | ||
| 6 | |##type##|No|The type deciding how the value is rendered, for fields that have no rendering of their own. Wrap the id in single quotes and prefix the type with an exclamation mark, as in ##'Custom Link'!url##. | ||
| 7 | |||
| 8 | == Standard Fields == | ||
| 9 | |||
| 10 | |=Id|=Label|=Type | ||
| 11 | |##summary##|Summary|##text## | ||
| 12 | |##key##|Key|##text## | ||
| 13 | |##type##|Type|##text## | ||
| 14 | |##status##|Status|##text## | ||
| 15 | |##assignee##|Assignee|##text## | ||
| 16 | |##reporter##|Reporter|##text## | ||
| 17 | |##created##|Created Date|##date## | ||
| 18 | |##updated##|Updated Date|##date## | ||
| 19 | |##resolved##|Resolved Date|##date## | ||
| 20 | |##fixVersion##|Fixed in|##text## | ||
| 21 | |##version##|Affected Versions|##text## | ||
| 22 | |##component##|Component|##text## | ||
| 23 | |##votes##|Votes|##number## | ||
| 24 | |##resolution##|Resolution|##text## | ||
| 25 | |##link##|Link|##url## | ||
| 26 | |##labels##|Labels|##list## | ||
| 27 | |||
| 28 | Any other field JIRA exposes can be displayed by using its **display name** as the id, which is how custom JIRA fields are reached. The complete list of fields available in a given instance is the one JIRA itself documents for [[JQL>>https://support.atlassian.com/jira-software-cloud/docs/jql-fields/]]. | ||
| 29 | |||
| 30 | == Default Fields per Style == | ||
| 31 | |||
| 32 | When ##fields## is left out, each style displays its own default set, in this order: | ||
| 33 | |||
| 34 | |=Style|=Fields | ||
| 35 | |##table##|##type##, ##key##, ##summary##, ##status##, ##created## | ||
| 36 | |##list##|##status##, ##key##, ##summary## | ||
| 37 | |##enum##|##status##, ##key## | ||
| 38 | |||
| 39 | == Field Types == | ||
| 40 | |||
| 41 | A field is rendered by the renderer registered for its id. Seven standard fields have one: ##created##, ##key##, ##labels##, ##resolved##, ##status##, ##type## and ##updated##. For every other field the renderer registered for the field **type** is used, and when the type has none either, the value is displayed exactly as JIRA returned it. | ||
| 42 | |||
| 43 | |=Type|=Rendering | ||
| 44 | |##text##|The value as JIRA returned it. | ||
| 45 | |##date##|The value rendered as a date. | ||
| 46 | |##url##|A link pointing at the value. The link label defaults to the value itself and can be changed with the ##field.url.label## entry of the ##parameters## Macro parameter. | ||
| 47 | |##html##|The value treated as HTML and injected as such. | ||
| 48 | |##number##|The value as JIRA returned it. There is no dedicated renderer for this type. | ||
| 49 | |##list##|The value as JIRA returned it, except for ##labels##, which has its own renderer. | ||
| 50 | |||
| 51 | Only ##date##, ##html## and ##url## have a type renderer, so those are the three types worth setting explicitly on a field. |
