Use teams to give specific read, write, or admin access to repositories. Teams can also let you create groups of members with similar interests for easier collaboration.

Team visibility

Teams can be visible or secret:

  • Visible teams can be viewed and @mentioned by every organization member, even if they aren't organization owners or members of those teams. If you make every team in your organization visible, your members will be able to use team @mentions across your organization.
  • Secret teams are only visible to the people on the team and people with owner permissions. They're great for hiding teams with sensitive names or team members, such as those used for working with external partners or clients.

Creating teams

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

  2. On the left side of your profile page, under "Organizations", click the icon for your organization. organization icons

  3. Under your organization name, click Teams. Teams tab

  4. On the right side of the Teams tab, click New team. New team button

  5. On the "Create new team" page, type the name for your new team. Team name field

  6. Optionally, in the "Description" field, type a description of the team. Team description field

  7. Choose whether the team will be visible or secret. You can change this option later in the team settings. Options for visibility including visible and secret

  8. After you review your choices, click Create team. Create team button
  9. Optionally, add repositories to the team.