Jira: Most-used fields#
The table below gives information about most-used fields that you can import from Jira. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
Assignee (assignee) |
Assignee (assignee) |
This field represents the user assigned to an issue. It contains details such as the user’s display name, email, and Atlassian account ID. An issue can also be unassigned. |
dimension |
Assignee (assignee).accountId |
Assignee (assignee).accountId |
The unique identifier for the assignee’s Atlassian account. |
dimension |
Assignee (assignee).accountType |
Assignee (assignee).accountType |
The type of the assignee’s account (e.g., ‘atlassian’, ‘app’, ‘customer’). |
dimension |
Assignee (assignee).active |
Assignee (assignee).active |
Indicates whether the assignee’s account is currently active. |
dimension |
Assignee (assignee).avatarUrls.16x16 |
Assignee (assignee).avatarUrls.16x16 |
The URL to the assignee’s 16x16 pixel avatar image. |
dimension |
Assignee (assignee).avatarUrls.24x24 |
Assignee (assignee).avatarUrls.24x24 |
The URL to the assignee’s 24x24 pixel avatar image. |
dimension |
Assignee (assignee).avatarUrls.32x32 |
Assignee (assignee).avatarUrls.32x32 |
The URL to the assignee’s 32x32 pixel avatar image. |
dimension |
Assignee (assignee).avatarUrls.48x48 |
Assignee (assignee).avatarUrls.48x48 |
The URL to the assignee’s 48x48 pixel avatar image. |
dimension |
Assignee (assignee).displayName |
Assignee (assignee).displayName |
The full name of the assignee, suitable for display. |
dimension |
Assignee (assignee).emailAddress |
Assignee (assignee).emailAddress |
The email address of the assignee. |
dimension |
Assignee (assignee).self |
Assignee (assignee).self |
The URL to the assignee’s user resource in the Jira API. |
dimension |
Assignee (assignee).timeZone |
Assignee (assignee).timeZone |
The time zone configured for the assignee’s account. |
dimension |
Created (created) |
Created (created) |
The date and time when the issue was created. |
dimension |
Description (description) |
Description (description) |
The detailed description of the issue. |
dimension |
Description (description).content.{NUM}.attrs.alt |
Description (description).content.{NUM}.attrs.alt |
The alternative text for an image or media element within the rich text description, used in the Atlassian Document Format (ADF) for accessibility purposes. |
dimension |
Description (description).content.{NUM}.attrs.colwidth.{NUM} |
Description (description).content.{NUM}.attrs.colwidth.{NUM} |
The width of a specific column within a table in the rich text description, as defined in the Atlassian Document Format (ADF). |
metric |
Description (description).content.{NUM}.attrs.height |
Description (description).content.{NUM}.attrs.height |
This field specifies the display height in pixels for a media item or other content block within the Atlassian Document Format (ADF) description of a Jira issue. |
metric |
Description (description).content.{NUM}.attrs.isNumberColumnEnabled |
Description (description).content.{NUM}.attrs.isNumberColumnEnabled |
A boolean attribute for table nodes within the issue description’s rich text, indicating if numbering is enabled for columns. |
dimension |
Description (description).content.{NUM}.attrs.language |
Description (description).content.{NUM}.attrs.language |
The language attribute for a code block or other content within the issue description’s rich text body, specifying the language of the content. |
dimension |
Description (description).content.{NUM}.attrs.layout |
Description (description).content.{NUM}.attrs.layout |
This field specifies the layout configuration for certain content blocks, such as media, within the Atlassian Document Format (ADF) description of a Jira issue. |
dimension |
Description (description).content.{NUM}.attrs.level |
Description (description).content.{NUM}.attrs.level |
The hierarchy level attribute for content within the issue description’s rich text body, particularly for headings (e.g., 1 for H1, 2 for H2). |
metric |
Description (description).content.{NUM}.attrs.localId |
Description (description).content.{NUM}.attrs.localId |
A local identifier for a node within the issue description’s rich text body, used for internal referencing within the Atlassian Document Format (ADF) structure. |
dimension |
Description (description).content.{NUM}.attrs.order |
Description (description).content.{NUM}.attrs.order |
The sequential position of a content block within the Jira issue’s rich text description. This attribute helps maintain the intended display order of various elements like paragraphs, lists, or code blocks. |
metric |
Description (description).content.{NUM}.attrs.panelType |
Description (description).content.{NUM}.attrs.panelType |
The type of panel used within the rich text description, part of the Atlassian Document Format (ADF). This specifies how content blocks like info panels, warning panels, etc., are rendered. |
dimension |
Description (description).content.{NUM}.attrs.state |
Description (description).content.{NUM}.attrs.state |
The ‘state’ attribute represents the current status or interactivity of an Atlassian Document Format (ADF) node in a Jira description. This can be relevant for interactive elements like action items or decision blocks, indicating if they are ‘open’ or ‘closed’. |
dimension |
Description (description).content.{NUM}.attrs.text |
Description (description).content.{NUM}.attrs.text |
The textual content of an element within the rich text description, as defined in the Atlassian Document Format (ADF). |
dimension |
Description (description).content.{NUM}.attrs.title |
Description (description).content.{NUM}.attrs.title |
The title attribute for an element within the rich text description, used in the Atlassian Document Format (ADF) to provide a heading or label for a content block. |
dimension |
Description (description).content.{NUM}.attrs.type |
Description (description).content.{NUM}.attrs.type |
The type attribute for a node within the rich text description’s content, such as ‘paragraph’, ‘text’, ‘link’, or ‘codeBlock’, used in the Atlassian Document Format (ADF). |
dimension |
Description (description).content.{NUM}.attrs.url |
Description (description).content.{NUM}.attrs.url |
The URL for a link or embedded media within the issue description. |
dimension |
Description (description).content.{NUM}.attrs.width |
Description (description).content.{NUM}.attrs.width |
This field specifies the display width in pixels for a media item or other content block within the Atlassian Document Format (ADF) description of a Jira issue. |
metric |
Description (description).content.{NUM}.attrs.widthType |
Description (description).content.{NUM}.attrs.widthType |
The ‘widthType’ attribute defines the width behavior of a block node within a Jira description, which is formatted using Atlassian Document Format (ADF). This attribute can determine how a content block, such as a media or layout element, scales or aligns within the available space. |
dimension |
Description (description).content.{NUM}.marks.{NUM}.attrs.color |
Description (description).content.{NUM}.marks.{NUM}.attrs.color |
This field stores the hexadecimal color code for text background applied to a segment of text within an issue’s description. It is an attribute of a ‘backgroundColor’ mark, part of the Atlassian Document Format (ADF) used for rich text in Jira. |
dimension |
Description (description).content.{NUM}.marks.{NUM}.attrs.href |
Description (description).content.{NUM}.marks.{NUM}.attrs.href |
The hyperlink reference for a text mark, such as a URL for a link, within the issue description. |
dimension |
Description (description).content.{NUM}.marks.{NUM}.type |
Description (description).content.{NUM}.marks.{NUM}.type |
The type of text formatting mark applied (e.g., ‘strong’ for bold, ‘em’ for italics, ‘link’ for hyperlink) within the issue description. |
dimension |
Description (description).content.{NUM}.text |
Description (description).content.{NUM}.text |
The actual text content within a block of the issue description. |
dimension |
Description (description).content.{NUM}.type |
Description (description).content.{NUM}.type |
The type of content block within the rich-text description (e.g., ‘paragraph’, ‘table’, ‘codeBlock’). |
dimension |
Description (description).type |
Description (description).type |
The ‘type’ field indicates the specific type of content block within a Jira description, which uses Atlassian Document Format (ADF). Examples of content types include ‘paragraph’ for text, ‘bulletList’ for bulleted lists, ‘codeBlock’ for code snippets, ‘mediaSingle’ for single media items, or ‘table’ for structured data. |
dimension |
Description (description).version |
Description (description).version |
The version of the Atlassian Document Format (ADF) used for the issue’s rich text description. |
metric |
Due date (duedate) |
Due date (duedate) |
The date by which the issue is scheduled to be completed. |
dimension |
Fix versions (fixVersions).archived |
Fix versions (fixVersions).archived |
Indicates if the fix version is archived. |
dimension |
Fix versions (fixVersions).description |
Fix versions (fixVersions).description |
A description of the fix version. |
dimension |
Fix versions (fixVersions).id |
Fix versions (fixVersions).id |
The unique identifier of the fix version. |
metric |
Fix versions (fixVersions).name |
Fix versions (fixVersions).name |
The name of the fix version. |
dimension |
Fix versions (fixVersions).releaseDate |
Fix versions (fixVersions).releaseDate |
The scheduled release date for the fix version. |
dimension |
Fix versions (fixVersions).released |
Fix versions (fixVersions).released |
Indicates if the fix version has been released. |
dimension |
Fix versions (fixVersions).self |
Fix versions (fixVersions).self |
The URL of the fix version object. |
dimension |
ID (id) |
ID (id) |
The unique internal identifier for the issue. |
dimension |
Issue Type (issuetype).avatarId |
Issue Type (issuetype).avatarId |
The ID of the avatar associated with this issue type. |
metric |
Issue Type (issuetype).description |
Issue Type (issuetype).description |
A brief description of the issue type. |
dimension |
Issue Type (issuetype).hierarchyLevel |
Issue Type (issuetype).hierarchyLevel |
The hierarchical level of the issue type within Jira (e.g., -1 for sub-task, 0 for standard, 1 for epic). |
metric |
Issue Type (issuetype).iconUrl |
Issue Type (issuetype).iconUrl |
The URL to the icon representing this issue type. |
dimension |
Issue Type (issuetype).id |
Issue Type (issuetype).id |
The unique identifier for the issue type. |
metric |
Issue Type (issuetype).name |
Issue Type (issuetype).name |
The name of the issue type (e.g., ‘Story’, ‘Bug’, ‘Task’). |
dimension |
Issue Type (issuetype).self |
Issue Type (issuetype).self |
The URL to the issue type’s resource in the Jira API. |
dimension |
Issue Type (issuetype).subtask |
Issue Type (issuetype).subtask |
Indicates whether this issue type is a sub-task. |
dimension |
Key (issuekey) |
Key (issuekey) |
The user-facing key of the issue (e.g., ‘PROJ-123’). |
dimension |
Labels (labels) |
Labels (labels) |
A list of labels applied to the issue for categorization and filtering. |
dimension |
Original estimate (timeoriginalestimate) |
Original estimate (timeoriginalestimate) |
The original estimated time to complete the issue, formatted as a string (e.g., ‘2d 4h’). This field represents the initial time estimate for the issue itself. |
metric |
Parent (parent).fields.issuetype.avatarId |
Parent (parent).fields.issuetype.avatarId |
The ID of the avatar associated with the issue type of the parent issue. |
metric |
Parent (parent).fields.issuetype.description |
Parent (parent).fields.issuetype.description |
A description of the issue type, providing details about its purpose or usage, for the parent issue. |
dimension |
Parent (parent).fields.issuetype.hierarchyLevel |
Parent (parent).fields.issuetype.hierarchyLevel |
The hierarchy level of the issue type, indicating its position in the issue type hierarchy (e.g., Epic, Story, Subtask) for the parent issue. |
metric |
Parent (parent).fields.issuetype.iconUrl |
Parent (parent).fields.issuetype.iconUrl |
The URL of the icon representing the issue type of the parent issue. |
dimension |
Parent (parent).fields.issuetype.id |
Parent (parent).fields.issuetype.id |
The unique identifier of the issue type for the parent issue. |
metric |
Parent (parent).fields.issuetype.name |
Parent (parent).fields.issuetype.name |
The name of the issue type for the parent issue. |
dimension |
Parent (parent).fields.issuetype.self |
Parent (parent).fields.issuetype.self |
The URL linking to the REST API resource for the issue type of the parent issue. |
dimension |
Parent (parent).fields.issuetype.subtask |
Parent (parent).fields.issuetype.subtask |
A boolean indicating whether the issue type of the parent issue is a subtask. |
dimension |
Parent (parent).fields.priority.iconUrl |
Parent (parent).fields.priority.iconUrl |
The URL of the icon representing the priority level of the parent issue. |
dimension |
Parent (parent).fields.priority.id |
Parent (parent).fields.priority.id |
The unique identifier of the priority level for the parent issue. |
metric |
Parent (parent).fields.priority.name |
Parent (parent).fields.priority.name |
The name of the priority level for the parent issue. |
dimension |
Parent (parent).fields.priority.self |
Parent (parent).fields.priority.self |
The URL linking to the REST API resource for the priority level of the parent issue. |
dimension |
Parent (parent).fields.status.description |
Parent (parent).fields.status.description |
A description of the status, providing details about its meaning or workflow stage, for the parent issue. |
dimension |
Parent (parent).fields.status.iconUrl |
Parent (parent).fields.status.iconUrl |
The URL of the icon representing the status of the parent issue. |
dimension |
Parent (parent).fields.status.id |
Parent (parent).fields.status.id |
The unique identifier of the status for the parent issue. |
metric |
Parent (parent).fields.status.name |
Parent (parent).fields.status.name |
The name of the status for the parent issue. |
dimension |
Parent (parent).fields.status.self |
Parent (parent).fields.status.self |
The URL linking to the REST API resource for the status of the parent issue. |
dimension |
Parent (parent).fields.status.statusCategory.colorName |
Parent (parent).fields.status.statusCategory.colorName |
The color name associated with the status category of the parent issue’s status, indicating its general state (e.g., ‘blue-gray’ for To Do, ‘yellow’ for In Progress, ‘green’ for Done). |
dimension |
Parent (parent).fields.status.statusCategory.id |
Parent (parent).fields.status.statusCategory.id |
The unique identifier of the status category for the parent issue’s status. |
metric |
Parent (parent).fields.status.statusCategory.key |
Parent (parent).fields.status.statusCategory.key |
The key identifying the status category for the parent issue’s status (e.g., ‘new’, ‘indeterminate’, ‘done’). |
dimension |
Parent (parent).fields.status.statusCategory.name |
Parent (parent).fields.status.statusCategory.name |
The name of the status category for the parent issue’s status (e.g., ‘To Do’, ‘In Progress’, ‘Done’). |
dimension |
Parent (parent).fields.status.statusCategory.self |
Parent (parent).fields.status.statusCategory.self |
The URL linking to the REST API resource for the status category of the parent issue’s status. |
dimension |
Parent (parent).fields.summary |
Parent (parent).fields.summary |
A brief, one-line synopsis or title of the parent issue, summarizing its purpose. |
dimension |
Parent (parent).id |
Parent (parent).id |
The unique identifier of the parent issue. |
metric |
Parent (parent).key |
Parent (parent).key |
This field stores the unique identifier (key) of the parent issue when the current issue is a sub-task. It establishes a hierarchical link between a sub-task and its main issue. |
dimension |
Parent (parent).self |
Parent (parent).self |
The URL linking to the REST API resource for the parent issue. |
dimension |
Priority (priority).iconUrl |
Priority (priority).iconUrl |
The URL to the icon representing the priority level of the issue. |
dimension |
Priority (priority).id |
Priority (priority).id |
The unique identifier of the priority level. |
metric |
Priority (priority).name |
Priority (priority).name |
The name of the priority level (e.g., ‘Highest’, ‘High’, ‘Medium’). |
dimension |
Priority (priority).self |
Priority (priority).self |
The URL of the priority object. |
dimension |
Project (project).avatarUrls.16x16 |
Project (project).avatarUrls.16x16 |
The URL of the 16x16 pixel avatar image for the project. |
dimension |
Project (project).avatarUrls.24x24 |
Project (project).avatarUrls.24x24 |
The URL of the 24x24 pixel avatar image for the project. |
dimension |
Project (project).avatarUrls.32x32 |
Project (project).avatarUrls.32x32 |
The URL of the 32x32 pixel avatar image for the project. |
dimension |
Project (project).avatarUrls.48x48 |
Project (project).avatarUrls.48x48 |
The URL of the 48x48 pixel avatar image for the project. |
dimension |
Project (project).id |
Project (project).id |
The unique identifier of the project. |
metric |
Project (project).key |
Project (project).key |
This field represents the unique identifier (key) for a Jira project. Project keys are short, uppercase alphanumeric strings used to quickly reference a project. |
dimension |
Project (project).name |
Project (project).name |
The full name of the project. |
dimension |
Project (project).projectCategory.description |
Project (project).projectCategory.description |
A description of the project category, providing context or details about the group of projects it represents. |
dimension |
Project (project).projectCategory.id |
Project (project).projectCategory.id |
The unique identifier of the project category. |
metric |
Project (project).projectCategory.name |
Project (project).projectCategory.name |
The name of the project category. |
dimension |
Project (project).projectCategory.self |
Project (project).projectCategory.self |
The URL linking to the REST API resource for the project category. |
dimension |
Project (project).projectTypeKey |
Project (project).projectTypeKey |
The key identifying the type of the project (e.g., ‘software’, ‘service_desk’, ‘business’). |
dimension |
Project (project).self |
Project (project).self |
The URL linking to the REST API resource for the project. |
dimension |
Project (project).simplified |
Project (project).simplified |
A boolean indicating whether the project is a simplified project (often associated with Next-gen or Team-managed projects). |
dimension |
Reporter (reporter) |
Reporter (reporter) |
This field represents the user who reported or created the Jira issue. It includes details such as their Atlassian account ID, display name, and email address. |
dimension |
Reporter (reporter).accountId |
Reporter (reporter).accountId |
The Atlassian account ID of the user who reported the issue. |
dimension |
Reporter (reporter).accountType |
Reporter (reporter).accountType |
The type of the reporter’s account (e.g., ‘atlassian’, ‘app’, ‘customer’). |
dimension |
Reporter (reporter).active |
Reporter (reporter).active |
A boolean indicating if the user who reported the issue is active. |
dimension |
Reporter (reporter).avatarUrls.16x16 |
Reporter (reporter).avatarUrls.16x16 |
The URL of the reporter’s 16x16 pixel avatar. |
dimension |
Reporter (reporter).avatarUrls.24x24 |
Reporter (reporter).avatarUrls.24x24 |
The URL of the reporter’s 24x24 pixel avatar. |
dimension |
Reporter (reporter).avatarUrls.32x32 |
Reporter (reporter).avatarUrls.32x32 |
The URL of the reporter’s 32x32 pixel avatar. |
dimension |
Reporter (reporter).avatarUrls.48x48 |
Reporter (reporter).avatarUrls.48x48 |
The URL of the reporter’s 48x48 pixel avatar. |
dimension |
Reporter (reporter).displayName |
Reporter (reporter).displayName |
The display name of the user who reported the issue. |
dimension |
Reporter (reporter).emailAddress |
Reporter (reporter).emailAddress |
The email address of the user who reported or created the Jira issue. |
dimension |
Reporter (reporter).self |
Reporter (reporter).self |
The API URL for the user who reported the issue. |
dimension |
Reporter (reporter).timeZone |
Reporter (reporter).timeZone |
The time zone of the user who reported the issue. |
dimension |
Resolved (resolutiondate) |
Resolved (resolutiondate) |
The date and time when the issue was resolved. |
dimension |
Status (status).description |
Status (status).description |
A brief description of the issue’s current status. |
dimension |
Status (status).iconUrl |
Status (status).iconUrl |
The URL to the icon representing the issue’s status. |
dimension |
Status (status).id |
Status (status).id |
The unique identifier for the issue’s status. |
metric |
Status (status).name |
Status (status).name |
The name of the issue’s status (e.g., ‘To Do’, ‘In Progress’, ‘Done’). |
dimension |
Status (status).self |
Status (status).self |
The URL to the issue status’s resource in the Jira API. |
dimension |
Status (status).statusCategory.colorName |
Status (status).statusCategory.colorName |
The color name associated with the issue’s status category (e.g., ‘blue-gray’, ‘green’). |
dimension |
Status (status).statusCategory.id |
Status (status).statusCategory.id |
The unique identifier for the issue’s status category. |
metric |
Status (status).statusCategory.key |
Status (status).statusCategory.key |
The key of the issue’s status category. |
dimension |
Status (status).statusCategory.name |
Status (status).statusCategory.name |
The name of the status category associated with the issue’s current status (e.g., To Do, In Progress, Done). |
dimension |
Status (status).statusCategory.self |
Status (status).statusCategory.self |
The URL of the status category object for the issue’s current status. |
dimension |
Status Category Changed (statuscategorychangedate) |
Status Category Changed (statuscategorychangedate) |
The date and time when the status category of an issue last changed, indicating a transition between major workflow stages (e.g., from ‘To Do’ to ‘In Progress’). |
dimension |
Summary (summary) |
Summary (summary) |
A concise overview or short description of the issue. |
dimension |
Time Spent (timespent) |
Time Spent (timespent) |
The total time, formatted as a string (e.g., ‘1h 30m’), that has been logged on an issue. |
metric |
Updated (updated) |
Updated (updated) |
The date and time when the issue was last updated. |
dimension |
author.accountId |
author.accountId |
The unique identifier of the user who created the attachment or comment. |
dimension |
author.accountType |
author.accountType |
The type of account for the user who created the attachment or comment (e.g., ‘atlassian’, ‘app’, ‘customer’). |
dimension |
author.active |
author.active |
Indicates if the user who created the attachment or comment is currently an active user in Jira. |
dimension |
author.avatarUrls.16x16 |
author.avatarUrls.16x16 |
The URL to the 16x16 pixel avatar image for the user who created the attachment or comment. |
dimension |
author.avatarUrls.24x24 |
author.avatarUrls.24x24 |
The URL to the 24x24 pixel avatar image for the user who created the attachment or comment. |
dimension |
author.avatarUrls.32x32 |
author.avatarUrls.32x32 |
The URL to the 32x32 pixel avatar image for the user who created the attachment or comment. |
dimension |
author.avatarUrls.48x48 |
author.avatarUrls.48x48 |
The URL to the 48x48 pixel avatar image for the user who created the attachment or comment. |
dimension |
author.displayName |
author.displayName |
The human-readable name of the user who created the attachment or comment. |
dimension |
author.emailAddress |
author.emailAddress |
The email address of the user who created the attachment or comment. |
dimension |
author.self |
author.self |
The URL of the user’s self-link for the user who created the attachment or comment. |
dimension |
author.timeZone |
author.timeZone |
The time zone set for the user who created the attachment or comment. |
dimension |
created |
created |
The date and time when the issue was created. |
dimension |
id |
id |
The unique internal ID of the issue. |
metric |
issueId |
issueId |
The unique internal ID of the issue. |
metric |
issueKey |
issueKey |
The user-friendly key for the issue (e.g., ‘PROJ-123’). |
dimension |
issuetype.description |
issuetype.description |
A description of the issue type. |
dimension |
issuetype.id |
issuetype.id |
The unique identifier of the issue type. |
metric |
issuetype.name |
issuetype.name |
The name of the issue type (e.g., ‘Bug’, ‘Task’, ‘Story’). |
dimension |
items.{NUM}.field |
items.{NUM}.field |
The name of the field that was changed in the issue’s changelog. |
dimension |
items.{NUM}.fieldId |
items.{NUM}.fieldId |
The ID of the field that was changed in the issue’s changelog. |
dimension |
items.{NUM}.fieldtype |
items.{NUM}.fieldtype |
The type of field that was changed in the issue’s changelog (e.g., ‘jira’, ‘custom’). |
dimension |
items.{NUM}.from |
items.{NUM}.from |
The raw value of the field before the change in the issue’s changelog. |
dimension |
items.{NUM}.fromString |
items.{NUM}.fromString |
The string representation of the field’s value before the change in the issue’s changelog. |
dimension |
items.{NUM}.tmpFromAccountId |
items.{NUM}.tmpFromAccountId |
The unique identifier of the user account from which a particular field value was changed in an issue’s history. |
dimension |
items.{NUM}.tmpToAccountId |
items.{NUM}.tmpToAccountId |
The unique identifier of the user account to which a particular field value was changed in an issue’s history. |
dimension |
items.{NUM}.to |
items.{NUM}.to |
The raw value of the field after the change in the issue’s changelog. |
dimension |
items.{NUM}.toString |
items.{NUM}.toString |
The string representation of the field’s value after the change in the issue’s changelog. |
dimension |
key |
key |
The user-friendly key for the issue (e.g., ‘PROJ-123’). |
dimension |
labels |
labels |
A list of text labels associated with the issue. |
dimension |
status.name |
status.name |
The name of the issue’s current status (e.g., ‘Open’, ‘In Progress’, ‘Closed’). |
dimension |
status.statusCategory.name |
status.statusCategory.name |
The name of the status category associated with the issue’s current status (e.g., To Do, In Progress, Done). |
dimension |
updated |
updated |
The date and time when the issue was last updated. |
dimension |