Skip to end of metadata
Go to start of metadata

Bitbucket lets you associate multiple email addresses with an account. These email addresses work site-wide. So, if your local DVCS username/email configuration uses any address on this list, Bitbucket automatically associates those with your account. Other Bitbucket users can find your account by any registered email address when searching for accounts or users.

You designate one address is the primary account address. Bitbucket sends email notifications to this address. You can change your primary address by clicking set as primary on any of your confirmed email addresses. This page contains the following topics:

Email addresses and commits

To map your username to a commit, push, and other activities, Bitbucket requires that the email address you commit with matches a validated email address on an account. On your local system, where you commit, both Git and Mercurial allow you to configure a global username/email and a repository specific username/email. If you do not specify a repository specific username/email values, both systems use the global default. So, for example, if your Bitbucket account has a validated email address of, you need to make sure your repository configuration is set for that username. Also, make sure you have set your global username/email address configuration to a validated email address.

If the global default is not configured or if you have not validated your email address, the committer appears as unknown for your Bitbucket activities. Also, if you have multiple Bitbucket accounts, you may mistakenly commit your code under an email address that maps to an account name you did not intend. To have the existing commits on a repository map to a different account, you can use  Username aliases for the repository in question. Aliases are per-repository. To set up an alias for a repository, you must have admin rights on it.

For information on configuring your local repository or configuring aliases, see Set your username for Bitbucket actions.

Confirming email addresses

When you register a new email address with your account, Bitbucket sends you an email containing a confirmation link. Until you confirm that address, Bitbucket cannot display your account name with your commits properly and other users cannot find you by that email address. Otherwise, Bitbucket performs as it normally would. If you have not confirmed your email address, a banner appears across the top of Bitbucket when log in:

If you've misplaced or your confirmation has expired, do the following:

  1. Select  Avatar>Manage Account. 
    The Manage page appears. 
  2. Select Email addresses.
  3. Click the resend confirmation link next to the address.


  1. Anonymous

    It would be great for a user to to be able to set which e-mail address receives messages from which repositories.

    1. Good idea.  Why not file an enhancement request? The voice of the (star)User(star) is always stronger than the writer's  — as it should be!

  2. Anonymous

    For me, it just lists my email address without an option to resend any confirmation.

    1. The option to resend only appears if you have not confirmed the address.  

  3. I have requested for a confirmation email but am unable to get one.

    Can anyone help me ?

    1. Gulshan, please send an email to and we can look into why you aren't receiving the confirmation.

      1. Thanks for your response Manthony, I will be doing that.