How to Alter the Favicon in Bitbucket Datacenter

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

Through the use of the Look and Feel for Bitbucket Data Center plugin you can customize the appearance of the Bitbucket Datacenter, such as altering the color scheme and adding a custom logo. You can also alter the favicon through the use of this plugin - so the default Bitbucket Server logo is changed in the URL bar or on the page tab.

Solution

Now, if you want to do this manually you can alter the favicon for Bitbucket Server by swapping out the favicon.ico file with your own file.

Steps

  1. Shutdown Bitbucket Server

  2. Locate the default file under "<bitbucket_installation_directory>/app/static/bitbucket/internal/images" folder.

  3. Remove/rename the default favicon file

  4. Add in your own favicon.ico file - ensuring it has the name favicon.ico

  5. Restart Bitbucket Server

If the favicon hasn't changed then clear the browser's cache or restart the browser for the change to take effect.

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.