Skip to main content

Adding your project to a team

You can add projects to teams to manage permissions and improve project discoverability.

Who can use this feature

Organization owners or people with the team maintainer role and admin permissions on a project can add a project to a team.

About adding projects to teams

You can add projects to your team to give the whole team collaborator access to their projects. When you add a project to a team, that project is listed on the team's projects page, making it easier for members to identify which projects a particular team uses.

Teams are granted read permissions on any project they are added to. This permission is added to existing permissions for the project and for individual team members, ensuring that any higher permissions are retained. For more information about setting permissions for teams and individual contributors, see "Managing access to your projects."

Adding a project to a team

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Click the name of your organization. Organization name in list of organizations

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

    Screenshot showing the team projects tab.

  6. Click Add project.

    Screenshot showing the "Add project" button.

  7. Start typing the name of the project you want to add and then select the project in the list of matches.

    Note: If this change will result in increased project permissions for the team's members, GitHub Enterprise Cloud will prompt you to confirm your choice.

    Screenshot showing the "Add project" form.

Removing a project from a team

  1. Navigate to your project.

  2. In the top-right, click to open the menu. Screenshot showing the menu icon

  3. In the menu, click Settings to access the project settings. Screenshot showing the 'Settings' menu item

  4. Click Manage access.

    Screenshot showing the "Manage access" item

  5. Next to the team that you want to remove from the project, click Remove.

    Screenshot showing removing a collaborator

Further reading