How to change the icon for Issue types
Platform Notice: Data Center Only - This article only applies to Atlassian apps 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
Jira Cloud
For Jira Cloud, please see How to change the Icon for Issue Types
This page explains how you can change the icon for Issue types.
Environment
Jira 8.x, 9.x, 10.x
Solution
1- Navigate to JiraAdministration > Issues > Issue types
2. On the Actions column, click on Edit next to the Issue type you would like to change
3. On Issue Type Avatar, click on select image
4. You can use one of the existing icons or upload a new one
MUST have a recognizable image extension (jpg, jpeg, gif, png)
Note: Due to an existing bug JRASERVER-63448 - Custom Issue Type Icon Not Showing in Issue Creation when changing the issue type icon to a custom image, the custom image is displayed everywhere in Jira (issue detail page and issue navigator) but not on the Issue create screen. It shows the default or previous image.
Workaround: Restart Jira after changing the icon.
Note 2: The icon will be changed for the issue type in all projects. It is not possible to have different avatars for the same issue type. Changing the icon will, therefore, affect all projects using this issue type.
If the icon does not appear after saving
Hard-refresh your browser (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows) to clear the locally cached avatar URL.
Log out and back in to Jira to clear any session-level icon caching.
If the icon appears correctly on the issue detail page and navigator but not on the Create Issue screen, this is a known bug (JRASERVER-63448). The workaround is to restart Jira after changing the icon.
Known Limitations
Custom uploaded icons should be square PNG images. Non-square images will be cropped automatically. Very large images may render at reduced quality in certain Jira views.
Icon changes do not retroactively update email notifications already sent. Historical notification emails will continue to display whichever icon was active at the time they were sent.
On Data Center clusters, if a node does not immediately display the updated icon, a hard browser refresh (Cmd/Ctrl+Shift+R) is usually sufficient to clear the browser’s cached avatar URL.
Was this helpful?