How Do I Change the Confluence Default 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
The customizations described on this page are outside the scope of Atlassian support. Please see Atlassian Support Offerings for more information.
Let's say you don't like some of the default icons in Confluence, like the one for the anonymous user:
And you would like to use something livelier, like a picture of a Lhasa Apso puppy:

To replace all you need to do is the following:
Shutdown Confluence
Navigate to
<Confluence Install>\confluence\images\icons\profilepics
There you will see an image file named
anonymous.png
(this is the image that represents the anonymous user icon)Backup the image
Open
anonymous.png
with an image editor so that you can find the image dimensions. In this case, the dimensions of the anonymous user icon is "48x48"Now edit the image you want to use instead and make sure that this image has the same dimensions as the icon you're replacing
You can use an online image re-sizer like http://www.picresize.com/ to change the file dimensions
After you replace the file, start Confluence
Enjoy!
Solution
Notes
In case you notice any misbehavior regarding your new icon, shutdown Confluence and restore the image you backed up previously.
When you upgrade Confluence, you will need to migrate your custom icons to the new installation directory (
<Confluence Install>\confluence\images\icons\profilepics)
.In case you want to edit other icons you can check the files at
<Confluence Install>\confluence\images\icons.
Be sure to replace the existing file with a new file using the samename.type
.
Was this helpful?