AWS CodeCommit
User Guide (API Version 2015-04-13)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Change Branch Settings in AWS CodeCommit

-You can change the default branch to use in the AWS CodeCommit console. You can use the AWS CLI to change the default branch for a repository. To change other branch settings, you can use Git from a local repo connected to the CodeCommit repository.

Change the Default Branch (Console)

You can specify which branch is the default branch in a CodeCommit repository in the AWS CodeCommit console.

  1. Open the CodeCommit console at

  2. In Repositories, choose the name of the repository where you want to change settings.

  3. In the navigation pane, choose Settings.

  4. In Default branch, choose the branch drop-down list and choose a different branch. Choose Save.

Change the Default Branch (AWS CLI)

To use AWS CLI commands with CodeCommit, install the AWS CLI. For more information, see Command Line Reference.

To use the AWS CLI to change a repository's branch settings in a CodeCommit repository, run the following command:

To change the default branch

  1. Run the update-default-branch command, specifying:

    • The name of the CodeCommit repository where the default branch is updated (with the --repository-name option).


      To get the name of the CodeCommit repository, run the list-repositories command.

    • The name of the new default branch (with the --default-branch-name option).


      To get the name of the branch, run the list-branches command.

  2. For example, to change the default branch to MyNewBranch in a CodeCommit repository named MyDemoRepo:

    aws codecommit update-default-branch --repository-name MyDemoRepo --default-branch-name MyNewBranch

    This command produces output only if there are errors.

For more options, see your Git documentation.