Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

This version of GitHub Enterprise was discontinued on 2023-03-15. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Converting an Owners team to improved organization permissions

If your organization was created after September 2015, your organization has improved organization permissions by default. Organizations created before September 2015 may need to migrate older Owners and Admin teams to the improved permissions model. The "Owner" is now an administrative role given to individual members of your organization. Members of your legacy Owners team are automatically given owner privileges.

You have a few options to convert your legacy Owners team:

  • Give the team a new name that denotes the members have a special status in the organization.
  • Delete the team after ensuring all members have been added to teams that grant necessary access to the organization's repositories.

Give the Owners team a new name

Note: Because "admin" is a term for organization members with specific access to certain repositories in the organization, we recommend you avoid that term in any team name you decide on. For more information, see "Repository roles for an organization."

  1. In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with the people icon and "Teams," is outlined in dark orange.

  4. In the list of teams, click Owners.

  5. Under the description of the new owner role, click Okay, got it.

  6. In the team name field, choose a new name for the Owners team. For example:

    • If very few members of your organization were members of the Owners team, you might name the team "Core".
    • If all members of your organization were members of the Owners team so that they could @mention teams, you might name the team "Employees".
  7. Under the team description, click Save and continue.

  8. Optionally, make the team public. For more information, see "Changing team visibility."

Delete the legacy Owners team

Warning: If there are members of your Owners team who are not members of other teams, deleting the team will remove those members from the organization. Before deleting the team, ensure members are already direct members of the organization, or have collaborator access to necessary repositories.

  1. In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with the people icon and "Teams," is outlined in dark orange.

  4. In the list of teams, click Owners.

  5. Under the description of the new owner role, click Okay, got it.

  6. At the bottom of the page, review the warning and click Delete the Owners team.