How to change the default Confluence icons
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
This guide explains how to modify the default Confluence icons to match your corporate colors or logos.
In the example below, the focus is on this Home icon:
⚠️IMPORTANT: As with all recommendations made by Atlassian Support, please follow best practices for Change Management and test and validate these settings in a Test/Development and Staging environment prior to rolling any changes into a Production environment. This is to validate these changes and ensure that they will function well within your infrastructure prior to placing these changes in production.
Solution
Shutdown Confluence
Navigate to <confluence-install>/confluence/WEB-INF/atlassian-bundled-plugins/
Make a backup copy of confluence-icons-1.0.8.jar, for example:
1$ cp confluence-icons-1.0.8.jar confluence-icons-1.0.8.jar.bak
Rename confluence-icons-1.0.8.jar to confluence-icons-1.0.8.zip
Unzip confluence-icons-1.0.8.zip
Navigate into confluence-icons-1.0.8/assets/icons
The orange home icon is named: confluence-icon-home.svg
Replace this with your new icon using the same name, filetype, and dimensions
Repeat step 5 for any other icons needing modification
Re-zip the parent folder & files into confluence-icons-1.0.8.zip
Rename confluence-icons-1.0.8.zip to confluence-icons-1.0.8.jar
Move your backup file confluence-icons-1.0.8.jar.bak to another location for safekeeping
Start Confluence
⚠️ These changes will be overwritten during an upgrade and require you to perform the above steps again.
Was this helpful?