How to upload Custom Priority Icons in Jira

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

We have a Product Suggestion to have this functionality built into Jira for future versions. Please consider voting and adding your comments on: JRASERVER-73784 - Provide upload functionality for Priority icons.

For more information on how Atlassian implements new functionality, take a look at our Implementation of New Features Policy.

As the Jira Installation Directory cannot be accessed directly in for the user to upload their icons, this KB will show users how to upload the priority icons to Jira.

(Auto-migrated image: description temporarily unavailable)

Solution

Jira Administrator permission is required to implement this solution.

  1. Upload your custom icon as an attachment to a Jira Issue that is readable by all users, and right click on the image and copy the image URL.

  2. Click Jira Settings > Issues > Priorities

  3. Click the 'Edit' link next to the desired priority.

  4. Paste the copied URL into the Icon URL field.

  5. Click the Update button.

(Auto-migrated image: description temporarily unavailable)

  • The custom icon will be saved as per upload

(Auto-migrated image: description temporarily unavailable)

In order to view the icon correctly, both condition below should be met:

  • The issue where the icons are uploaded should be accessible by all logged in Jira users

  • In the case where the icons are not showing up, please check on the issue itself and ensure you are able to view the attachments OR the URL to access the attached icons has not changed

Alternative

To upload to a public image hosting site and paste the URL back to Jira.

The example below is intended just for reference. We don't own the suggested site, and recommend that you don't use the suggested solution if your icon contains sensitive information that shouldn't be made available to public internet.

Example:

  1. Find an image hosting site (https://imgur.com is an option.)

  2. Upload the image file and after getting the image on the site, right click and choose to:

    1. https://i.imgur.com/PvkVuiK.png

  3. Click cog icon > Issues > Priorities

  4. Click the Edit link next to the desired priority.

  5. Paste the copied URL into the Icon URL field.

    (Auto-migrated image: description temporarily unavailable)

This is also subject to the image hosting site's availability, please visit the site to check if the image no longer showing correctly or showing as a dead link.

For On-Prem (Data Center and Server)

The location for storing custom images is relative to the $Jira-Installation directory path.

Example:

/images/icons/zcustomicon.gif on the UI translates to $Jira-Installation/atlassian-jira/images/icons/zcustomicon.gif on the server.

(Auto-migrated image: description temporarily unavailable)
1 2 3 4 % pwd $JIRA_INSTALL/atlassian-jira/images/icons % ls zcustomicon.gif zcustomicon.gif

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.