How to change username?

How can I change/specify the username used for my commits? I am committing to BitBucket, and using SourceTree my commit-name is now fullname_emailAddress (or a format close to that).

I have used MacHG so far, where I have added the following to the hgrc file for MacHg


username = myShortBitBucketUserName

But if I add those lines to my repo-config i SourceTree the line with the username is just deleted again.

I have tried to change my user-info as specified here

But whenever I change my name, the change is reverted when I re-open the settings?

3 answers

1 accepted

1 vote
Accepted answer

Your commits are actually nothing to do with your Bitbucket account (although you might use the same email address). Commits in a DVCS are entirely local, so you specify two things to identify the commits as yours:

  1. Your full name
  2. Your email address

Later when you push these commit to somewhere else, you may need authentication to do so (e.g. your Bitbucket user name), but this is completely separate from the commit user details. For example, you may actually push a commit someone else has created, meaning the commit user is different from the user you use to push.

Anyway, to change the details used to commit in SourceTree can be done in two places:

  1. Preferences > General: fill in the Full name and Email address fields. These details will apply to all repositories unless you change it
  2. In the repository window, click Settings in the top-right, then Advanced. Here you can change the same details just for this single repository, allowing you to, for example, use a work email address to commit to one repository and a personal email address for another.

Thanks for your reply.

What I am trying to achieve is to commit using my BitBucket alias name instead of using "fullname_<email_address>".

I have a python script running for "commit-blame" - it will fire a USB rocket launcher towards the developer who broke the (Jenkins) build. That python script contains all developers BitBucket aliases, but committing/pushing using SourceTree, the alias is now no longer used.

But from your reply it doesn't look like using the alias is possible? I tried to add my alias in the Full Name input, but the email address is still being appended.

It's just not how you're supposed to commit to a DVCS, the commits are supposed to be unique irrespective of hosting service, that's why there's a full name and email address. Perhaps you should just use a mapping table in your python script to translate emails to Bitbucket user names if you want to integrate that way, or maybe you should just program your rocket launcher to identify people by email?

On Windows version 1.6 SourceTree there is no Preferences > General - instead look under Tools > Options > General

working like a charm 👌
You also have to restart SourceTree app.

For MAC::

1) Click on top-right corner Settings icon

2) Click on Remotes tab

3) Select the repository for which you want to change the user name

4) Click on Edit button

5) Change the user name in Username text field


If after makign above changes, you still see the old user name while pull/commit operations, than change the repository url from http://<olduser>@git.<Server>.com:.. to http://<newuser>@git.<server>.com....


It works for me, and i hope it works for you too :-) 



Amit Mittal

In source tree menu tools>options>general>default user information  here you can edit your username & mailid.



Suggest an answer

Log in or Sign up to answer
Community showcase
Published Oct 23, 2018 in Sourcetree

Tip from the team: configure your repos for hosting goodness!

Supported Platforms macOS Windows We recently introduced support for additional hosting services such as GitHub Enterprise, GitLab (Cloud, Community Edition, Enterprise Edition), and...

962 views 4 2
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you