Your Bitbucket username is the handle you chose when you created your account, and you can find it in your account settings or by looking at your profile URL

When you sign up for Bitbucket, you pick a username during registration — this is different from your email address and different from your display name. That username is what appears in your repository URLs, in commit history, and when you collaborate with other developers. If you have forgotten it, there are three straightforward places to check.

Your username is permanent and cannot be changed after account creation, so the one you set at signup is the one you will use for all technical purposes on Bitbucket.

Key Takeaways

  • Your Bitbucket username appears in your repository URLs in the format bitbucket.org/yourusername/repositoryname.
  • You can view your username by logging into Bitbucket, clicking your profile icon in the bottom left corner, and selecting Personal settings.
  • Your username is listed under the Username field on your account page, separate from your email address and display name.
  • If you use Bitbucket through a workspace, your personal username is still the same, but you may also have workspace-specific roles or permissions.

Check your profile settings in Bitbucket

The most direct way to find your username is to log into your Bitbucket account. Once you are logged in, look for your profile icon — usually a small circle or avatar — in the bottom left corner of the screen. Click it and select Personal settings from the menu that appears.

On the Personal settings page, your username will be displayed near the top under the Username field. This is the exact handle you use for authentication, repository access, and team collaboration. Write it down or copy it if you need it for configuration files or documentation.

Look at your repository URL

If you have already created repositories in Bitbucket, your username is embedded in the URL. Any repository you own will have a URL that follows this pattern: bitbucket.org/yourusername/repositoryname. The part between the first slash and the second slash is your username.

You can find this URL by visiting any of your repositories and looking at the address bar in your browser, or by clicking the Clone button on a repository page. The HTTPS and SSH clone URLs both include your username in the same position.

Check your email confirmation or account recovery

When you first created your Bitbucket account, you received a confirmation email. That email may still be in your inbox or in your email archive. The confirmation message often includes your username or a link to your profile that displays it.

If you no longer have access to that email, you can use Bitbucket's account recovery process. Go to the Bitbucket login page, click Can't log in?, and follow the prompts to verify your identity using your email address. Bitbucket will send you a password reset link, and once you reset your password and log in, you will be able to see your username in Personal settings.

Difference between username, display name, and email

Bitbucket lets you set three different identifiers, and it is straightforward to mix them up. Your username is the unique handle you chose at signup — it is permanent, cannot contain spaces, and is what appears in URLs and commit history. Your display name is optional and can include spaces and special characters; it is what other users see when they view your profile, but it does not appear in repository URLs. Your email address is what you use to log in, but it is separate from your username.

If you have changed your display name but cannot remember your username, go back to Personal settings and look for the Username field specifically — that is the one you need for technical purposes like cloning repositories or configuring Git.

What to do if you cannot access your account

If you cannot log into Bitbucket at all, you cannot view your username through the settings page. In that case, try the account recovery process first: go to the login page, click Can't log in?, and enter the email address associated with your account. Bitbucket will send you a link to reset your password.

If you do not remember which email address you used, or if you no longer have access to that email, contact Bitbucket Support through their help portal. You will need to verify your identity, but they can help you regain access to your account and confirm your username once you do.

Using your username in Git configuration

Once you have your username, you may need to use it in Git commands or configuration files. When you clone a repository using HTTPS, Git will prompt you for your username and password. When you use SSH, your username is included in the clone URL automatically. If you are setting up a new machine or configuring Git for the first time, having your username handy will speed up the process.

You can also set your username in your local Git configuration so that it appears in your commit history. Use the command git config user.name "Your Display Name" to set how your name appears in commits, which is different from your Bitbucket username but often set to the same value for clarity.

Frequently Asked Questions

Can I change my Bitbucket username?

Bitbucket does not allow you to change your username after account creation. If you need a different username, you would need to create a new account. However, you can change your display name at any time in Personal settings, which is what other users see on your profile.

Is my Bitbucket username the same as my Atlassian account username?

Not necessarily. If you use Bitbucket through an Atlassian account (which handles multiple Atlassian products like Jira and Confluence), your Bitbucket username is still separate. Log into Bitbucket specifically and check Personal settings to see your Bitbucket username.

What if I have a workspace account and a personal account?

Your personal Bitbucket username remains the same whether you work in a workspace or not. Workspaces are team containers, but your individual username is tied to your personal account. You can view it in Personal settings regardless of which workspace you are currently viewing.

Do I need my username to clone a repository?

When you clone using HTTPS, Git will ask for your username and password. When you clone using SSH, your username is already in the URL. Either way, having your username available makes the process smoother, especially if you are setting up a new machine.