Rename the Git default branch

Before 2021, the default branch in Git repositories was named master. Adobe and other tech industry companies want to avoid non-inclusive terminology such as “master branch” that implies a “master/slave” relationship. As a result, default branches in new repos are now named main. We asked writers to change the default branch name from master to main. Nearly all repos now have main default branches.

If your repo is one of the few to still have a default branch called master, please rename it, unless the repo will soon be end-of-life or there are other considerations such as APIs associated with that repo.

Renaming the default branch

The only mildly tricky part for writers is to make sure you update your local clones properly.

  1. (Everyone on team) If you’re working on a team, pick a date and make sure that everyone on the team is ready.

  2. (Everyone on team) Make sure your local clone is synced with server so that you don’t lose any editing changes.

    • Sync clone - Before renaming your branch, save changes to files in Visual Studio Code, commit any changes to a branch, and upload those changes to the server.
    • Pull requests - It is not necessary to merge pull requests before renaming the branch. Git updates the branch name change in any pull request.

    sync clone

  3. (One team member) In your repo on Git corp, open Settings > Branches.

  4. Click the Rename branch (pencil) icon, and rename master to main.

    Rename branch

  5. (Everyone on team) Remove and re-create the repo clone.

    1. (Remove clone) In the GitHub Desktop main menu, choose Repository > Remove. Select the option to remove the files unless you want to keep a backup. If you don’t remove the local files, move them to a different location before you re-clone the repo.
    2. (Re-create clone) In a browser, go to the repo root: https://git.corp.adobe.com/adobedocs/<reponame> and choose Code > Open with GitHub Desktop. For details, see Git setup: Clone a repo.
    NOTE

    It might be possible to use command lines to update your clone, but because of Enterprise sign-in issues, we think it’s easier to remove and re-create the clone.

  6. (Optional) Let Bob know via Slack or email so that he can track progress. (Bob gets an automated alert when a repo branch is renamed.)

Branch name status of EXL repos

Repo Branch Name Date Changed
adobe-consulting-services.en main Jan 10, 2022
adobe-developers-live-events.en main Jan 10, 2022
adobe-system-status.en main Dec 2021
acrolinx-testing.en main Nov. 2021
advertising-cloud-learn.en main Dec 2021
advertising-cloud.en main Dec 2021
aem-forms-automated-conversion-service.en main Dec 22, 2021
aem-guides-wknd-assets-docs.en main Dec 22, 2021
analytics-learn.en main Dec 15, 2021
analytics-platform.en main Dec 10, 2021
analytics.en main Nov. 2021
asset-compute.en main Dec 22, 2021
audience-manager-admin.en main Dec 20, 2021
audience-manager-learn.en main Dec 15, 2021
audience-manager.en main Dec 20, 2021
auditor.en master Near EOL, TBD
authoring-guide-exl.en main Dec 10, 2021
bizible.en main Dec 22, 2021
blueprints-learn.en main Dec 14, 2021
campaign-classic-learn.en main Dec 10, 2021
campaign-classic.en main Dec 16, 2021
campaign-learn.en main Dec 10, 2021
campaign-standard-learn.en main Dec 10, 2021
campaign-standard.en main Dec 16, 2021
campaign.en main Dec 16, 2021
commerce-admin.en main Nov. 2021
commerce-channels.en main Dec 10, 2021
commerce-cloud-service.en main Dec. 8, 2021
commerce-learn.en main Dec 13, 2021
commerce-merchant-services.en main Nov. 2021
commerce-operations.en Main Dec 10, 2021
contextualhelptest.en master Test config repo
contributor.en main Nov. 2021
control-panel.en main Dec 16, 2021
core-services.en main Dec. 1, 2021
courses.en main Jan 2022
creative-cloud-enterprise-learn.en main Dec 21, 2021
creative-cloud-enterprise.en main Jan 2021
customer-care-office-hours.en main Jan 2021
customer-journey-analytics-learn.en main Dec 15, 2021
customer-one.en main Jan 2021
cxm-learn.en main Jan 2021
data-workbench.en main Dec 10, 2021
debugger.en master Near EOL, TBD
deliverability-learn.en main Dec 10, 2021
device-co-op.en main Jan 2022
document-cloud-learn.en main Dec 21, 2021
document-cloud-sign.en main Jan 19, 2022
document-services.en main Dec 21, 2021
dynamic-media-classic.en main Dec. 9, 2021
dynamic-media-developer-resources.en main Dec. 9, 2021
exc.en main Jan 2022
experience-cloud-kcs.en master Don’t rename; 3rd-party APIs
experience-cloud.en main Jan 2022
experience-league-live-events.en main Dec 13, 2021
experience-manager-64.en main Dec 22, 2021
experience-manager-65.en main Dec 22, 2021
experience-manager-assets-essentials.en main Dec 22, 2021
experience-manager-brand-portal.en main Dec 22, 2021
experience-manager-cloud-manager.en main Dec 22, 2021
experience-manager-cloud-service.en main Dec 22, 2021
experience-manager-core-components.en main Dec 21, 2021
experience-manager-desktop-app.en main Dec 22, 2021
experience-manager-dispatcher.en main Dec 22, 2021
experience-manager-document-security.en main Dec 22, 2021
experience-manager-forms-cloud-service.en main (decom) Dec 21, 2021
experience-manager-gems.en main Dec 22, 2021
experience-manager-htl.en main Dec 14, 2021
experience-manager-learn.en main Dec. 9, 2021
experience-manager-pattern-detection.en main Dec 22, 2021
experience-manager-release-information.en main Dec 22, 2021
experience-manager-screens.en main Dec 22, 2021
experience-manager-skill-builder.en main Jan 2022
experience-manager-xml-documentation-learn.en main Jan 2022
experience-platform.en main Dec 14, 2021
id-service.en main Jan 2022
internal-enablement.en master Internal test repo
journey-optimizer-learn.en main Dec 10, 2021
journey-optimizer.en main Dec 16, 2021
journey-orchestration-learn.en main Dec 10, 2021
journeys.en main Dec 16, 2021
livefyre.en main Nov. 2021
marketo.en main Dec 22, 2021
media-analytics.en main Dec 20, 2021
mobile-services.en main Jan 2022
offer-decisioning.en main Dec 16, 2021
partner-exchange.en main Jan 2022
places.en main Jan 2022
platform-learn.en main Dec 14, 2021
primetime.en main Dec 22, 2021
release-notes.en main Dec 10, 2021
sandbox.en main Nov. 2021
search-promote.en main Dec. 9, 2021
sign-integrations.en main Jan 2022
skill-builder-events.en main Jan 2022
skill-exchange-events.en main Jan 2021
social.en main Nov. 2021
support-resources.en main Nov. 2021
target-learn.en main Jan 2021
target.en main Dec. 8, 2021
workfront-learn.en main Dec 8, 2021

On this page