How to change the default Confluence icons

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the server and data center platforms.


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: 

(warning) 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.


  1. Shutdown Confluence
  2. Navigate to <confluence-install>/confluence/WEB-INF/atlassian-bundled-plugins/
  3. Make a backup copy of confluence-icons-1.0.8.jar, for example:

    $ cp confluence-icons-1.0.8.jar confluence-icons-1.0.8.jar.bak
  1. Rename confluence-icons-1.0.8.jar to
  2. Unzip
  3. Navigate into confluence-icons-1.0.8/assets/icons
  4. The orange home icon is named: confluence-icon-home.svg
  5. Replace this with your new icon using the same name, filetype, and dimensions
  6. Repeat step 5 for any other icons needing modification
  7. Re-zip the parent folder & files into
  8. Rename to confluence-icons-1.0.8.jar
  9. Move your backup file confluence-icons-1.0.8.jar.bak to another location for safekeeping
  10. Start Confluence

(warning) These changes will be overwritten during an upgrade and require you to perform the above steps again. 

DescriptionHow to change the default confluence icons
ProductConfluence server, Confluence data center
Last modified on Apr 15, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.