Configure Gravatar URLs in Bitbucket

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

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:

1 2 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

Solution

Disable Gravatar Support:

  1. Clickthe

    (Auto-migrated image: description temporarily unavailable)

    icon in the Bitbucket header.

  2. Click Avatars.

  3. Unselect "Enable Gravatar support"

  4. 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":

1 2 3 SELECT * FROM app_property WHERE prop_key = 'avatar.source';
Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.