Show custom fields in issues list and detail pages

[srijan]

Is there a way to show additional custom field information in the issues list table and in the issue detail page?

Note that custom fields can be of type string/datetime/user/link etc.

(Originally published at: https://srijan.ch/notes/2025-04-15-001)

[unmonoqueteclea]

I'm still figuring out how to expose this through the configuration. It's on my TODO list, but I’m not sure when I’ll get to it. In the meantime, here’s some information about how it currently works:

• The jira-fields variable holds the data for all custom fields. It's automatically populated when you open the issues list.
• The jira-issues-fields variable (defined in jira-utils.el) maps the paths for all fields in use—both custom and standard. You can find examples of custom fields there, each using a formatter function defined in `jira-fmt.el. For example:

(:cost-center . ((:path . (fields (custom "Cost center")))
                 (:columns . 10)
                 (:name . "Cost Center")
                 (:formatter . jira-fmt-cost-center)))

• Finally, you can include that field in the list of fields shown in the issues list, which is already a configurable parameter jira-issues-table-fields

[srijan]

Thanks, will try it out.

Any similar workarounds for issue details pages?

[MindTwister]

While not exactly straightforward it is doable, I configured it like this

(add-to-list 'jira-issues-fields '(:story-points . ((:path . (fields customfield_10030))
          (:columns . 5)
          (:name . "Story Points"))))

[srijan]

I had to use this for showing a new custom field:

;; Issue fields customizations - define the epic link field
(add-to-list 'jira-issues-fields
             '(:epic-link . ((:path . (fields customfield_10002))
                             (:columns . 12)
                             (:name . "Epic Link")
                             (:formatter . jira-fmt-issue-key-not-tabulated))))

;; Add epic link to the detail view's Team Data section
(defun my/jira-detail-add-epic-link (issue)
  "Insert epic link in the Team Data section of jira detail view."
  (let ((epic-link (jira-detail--issue-fmt issue :epic-link)))
    (insert (jira-detail--header "Epic Link") (or epic-link "") "\n")))

(advice-add 'jira-detail--issue-team :after #'my/jira-detail-add-epic-link)