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.

In this article

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 upper-right corner of GitHub, select your profile photo, then click Your organizations**.

  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 upper-right corner of GitHub, select your profile photo, then click Your organizations**.

  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.