How to Change Git Config Username and Email?

Git uses your username and email address to identify who made each commit in a project’s history. Configuring your Git identity correctly is essential for accurate attribution and helps you avoid identity conflicts when collaborating on projects. Whether you need to update your details globally or for a specific project, this guide will walk you through how to change your Git username and email in a few straightforward steps.

Why Update Your Git Username and Email?

Updating your Git configuration can be essential in several situations:

• Changing Your Username or Email: If your email or username changes, you may need to reflect this change in your Git settings to keep a consistent commit history.
• Switching GitHub or Git Accounts: If you switch from one GitHub account to another, it’s essential to update your Git configuration to ensure commits are attributed to the correct account.
• Configuring Multiple Projects: You might use different identities for different projects, particularly if working on open-source, personal, and professional projects.

---

Types of Git Configurations

Before making changes, it’s important to understand the three levels of Git configuration:

1. Global Configuration (--global): Applies the configuration to all repositories on your system.
2. Local (Project-Specific) Configuration: Only affects the Git repository within a specific project.
3. System Configuration (--system): Usually managed by an administrator, applies system-wide, and requires administrative privileges.

For most cases, updating your global or local configuration should be sufficient.

---

Step 1: Checking the Current Username and Email

To verify your current Git configuration for username and email:

1. Open a Terminal or Git Bash window.
2. Use the following command to view your current configuration:

   git config --global --list

This command will display your global Git settings, including the user.name and user.email. If you want to check a specific project’s configuration, navigate to the project folder and run:

   git config --list

---

Step 2: Updating the Global Git Username and Email

To change your username and email globally, which will affect all repositories on your machine:

1. Open a Terminal or Git Bash window.
2. Update your username with the following command:

   git config --global user.name "YourNewUsername"

3. Update your email with this command:

   git config --global user.email "[email protected]"

4. Verify the update:

   git config --global --list

You should see the updated values for user.name and user.email.

Note: Using --global applies these changes to all repositories on your machine. Be cautious when updating the global configuration, especially if you manage multiple accounts or projects.

---

Step 3: Updating the Username and Email for a Specific Repository

To set a different username and email for a specific project, follow these steps:

1. Navigate to Your Project Directory:

   cd /path/to/your/project

2. Set the Local Username:

   git config user.name "YourProjectSpecificUsername"

3. Set the Local Email:

   git config user.email "[email protected]"

4. Verify the Local Configuration:

   git config --list

The output should show your custom user.name and user.email for that project only.

Local configuration changes apply only to the current repository, which is particularly useful if you have multiple GitHub or Git accounts or if you want different attribution for various projects.

---

Step 4: Editing the Configuration File Directly (Optional)

If you prefer a more hands-on approach, you can directly edit Git’s configuration file to make these changes.

1. Locate the Configuration File:

• For global settings, open ~/.gitconfig.
• For project-specific settings, open .git/config in the project’s root directory.

1. Edit the Username and Email:

• Open the file in a text editor and locate the [user] section.
• Update the name and email fields: [user] name = YourUpdatedUsername email = [email protected]

1. Save the File and close the text editor.

This method can be helpful if you’re comfortable working with configuration files directly or if you’re automating setup processes.

---

Step 5: Verifying the Changes

To confirm that Git is using the updated username and email, you can make a test commit:

1. Create a Test File in your project directory:

   echo "Test content" > testfile.txt

2. Add the File to the staging area:

   git add testfile.txt

3. Commit the File:

   git commit -m "Test commit to verify Git configuration"

4. Check the Commit Log:

   git log -1

The commit log should show the updated user.name and user.email in the commit details.

---

Quick Summary of Commands

Configuration Level	Command
View global configuration	git config --global --list
Update global username	git config --global user.name "YourNewUsername"
Update global email	git config --global user.email "[email protected]"
Update local username	git config user.name "YourProjectSpecificUsername"
Update local email	git config user.email "[email protected]"

---

Conclusion

Keeping your Git username and email up to date is essential for accurate commit attribution, especially when collaborating on projects. Whether you’re updating details globally or for specific repositories, following these steps will ensure your commits reflect the correct identity. As you become more comfortable with Git, these configuration updates will be second nature, helping you manage multiple projects and accounts smoothly.