How do I apply the default custom user and group avatars in Bitbucket Server
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
To change the default user and group avatars in Bitbucket Server to your custom avatars, follow the steps listed below:
1. Disable Gravatar support in Bitbucket Server under Administration -> Accounts -> Avatars and uncheck "Enable Gravatar support" - (only for user avatar customisation)
2. Shut down Bitbucket Server
3. Rename the existing default-avatar-*.png images to default-avatar-*-original.png in <BITBUCKET_INST>/atlassian-bitbucket/static/images/avatar based on which avatars you wish to customise and replace them with your custom images
4. Start up Bitbucket Server
5. Invalidate the browser cache by pressing (Cmd+Shift+R) on the respective user or group profile screens in Bitbucket Server
Was this helpful?