As an organization owner or project board admin, you can give a team access to a project board owned by your organization.

Warnings:

  • You can change a team's permission level if the team has direct access to a project board. If the team's access to the project board is inherited from a parent team, you must change the parent team's access to the project board.
  • If you add or remove project board access for a parent team, each of that parent's child teams will also receive or lose access to the project board. For more information, see "About teams."

Giving a team access to a project board

You can give an entire team the same permission level to a project board.

Note: If a person has multiple avenues of access to an organization project board (individually, through a team, or as an organization member), the highest project board permission level overrides lower permission levels. For example, if an organization owner has given a team read permissions to a project board, and a project board admin gives one of the team members admin permissions to that board as an individual collaborator, that person would have admin permissions to the project board. For more information see, "Project board permissions for an organization."

  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 Projects. Projects tab for your organization

  4. In the projects list, click the name of the project board. Select project

  5. On the top-right side of the project board, click Menu.

  6. Click , then click Settings. Settings option in drop-down menu from project board sidebar

  7. In the left sidebar, click Teams.

  8. To add a team, click Add a team: Select team. Then, choose a team from the drop-down menu or search for the team you'd like to add. Add a team drop-down menu with list of teams in organization
  9. Next to the team name, use the drop-down menu to select the desired permission level: Read, Write, or Admin. Team permissions drop-down menu with read, write, and admin options

Removing a team's access to a project board

If a team's access to a project board is inherited from a parent team, you must remove the parent team's access to the project board so that its child teams no longer have access.

  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 Teams tab, click the name of the team. List of the organization's teams

  5. Above the team's conversation, click Projects. The team repositories tab

  6. Next to the project board you want to remove, click the Trash icon. Remove a project board from your team trash button