Configure Gravatar URLs in Bitbucket
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles 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
Per BSERV-3112 - Change Gravatar server URL, it is now possible to configure Gravatar URLs in Bitbucket Server, this can be set in the bitbucket.properties file. The following properties are responsible for this:
avatar.url.format.http
avatar.url.format.https
The following format parameters are available for the above mentioned properties:
- %1$s -> The user's e-mail address, MD5 hashed, or "00000000000000000000000000000000" if the user has no e-mail.
- %2$d -> The requested avatar size.
- %3$s -> The fallback URL, URL-encoded, which may be defined using "avatar.url.default".
- %4$s -> The user's e-mail address, not hashed, or an empty string if the user has no e-mail.
So the above parameters can be specified in bitbucket.properties following these examples:
avatar.url.format.http=http://www.gravatar.com/avatar/%1$s.jpg?s=%2$d&d=%3$s
avatar.url.format.https=https://secure.gravatar.com/avatar/%1$s.jpg?s=%2$d&d=%3$s
Disable Gravatar Support:
- Click the icon in the Bitbucket header.
- Click Avatars.
- Unselect "Enable Gravatar support"
- Save
If you need to audit this value outside of the UI, you can use this SQL to confirm Gravatr is disabled. This should return "disabled":
SELECT *
FROM app_property
WHERE prop_key = 'avatar.source';