Rename the pymongo default branch from master to main

XMLWordPrintableJSON

    • Type: Task
    • Resolution: Unresolved
    • Priority: Major - P3
    • None
    • Affects Version/s: None
    • Component/s: Infrastructure
    • None
    • Python Drivers
    • Not Needed
    • None
    • None
    • None
    • None
    • None
    • None

      GitHub has been encouraging all repositories to rename their default branch from master to main. See GitHub's explanation and tooling guide: https://github.com/github/renaming

      Internal precedent:

      • DOP-3949 — "Rename our primary branches to main" (closed/fixed): Establishes that "All DOP-managed repositories use main as their primary branch name."
      • CSHARP-5197 — "Rename default branch to main": Documents how the C# driver completed this. Specifically: renamed the default GitHub branch to main and updated Evergreen configuration to match.

      Steps to complete:

      1. Rename the master branch to main on GitHub (GitHub's rename tool automatically retargets open PRs)
      2. Set main as the default branch in repository settings
      3. Update Evergreen project configuration to reference main instead of master
      4. Audit any other CI, bot, or automation references to master (e.g. release scripts, .github/ workflows)
      5. Update contributor documentation that mentions master

      *Notes for users:"

      1. We will make the naming change on 14 July 2026.
      2. If you are specifically cloning our master branch in CI, you will have to update to use main after the change.
      3. If you have a local clone, you will have to follow the instructions for updating your clone.

            Assignee:
            Alex Clark
            Reporter:
            Alex Clark
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated: