Skip to main content
All products
Organizations

This version of GitHub Enterprise was discontinued on 2023-07-06. 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.

Managing team access to an organization project board

In this article

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 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 Projects.

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

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

  6. Click , then click Settings.

    Screenshot showing the project menu. The settings option is highlighted with an orange outline.

  7. In the left sidebar, click Teams.

  8. To add a team, click Add a team: Select team. Then, choose a team from the dropdown menu or search for the team you'd like to add.

  9. Next to the team name, use the dropdown menu to select the desired permission level: Read, Write, or Admin.

Configuring 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 change the parent team's access to the project board to update access to the child teams.

  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. Click the name of the team.

  5. Above the team's conversation, click Projects.

    Screenshot of the main page for a team. In the horizontal navigation bar, the "Projects" tab is outlined in dark orange.

  6. To change permissions levels, to the right of the project board you want to update, use the permission level dropdown menu.