Skip to main content

Managing access to your projects

Learn how to manage team and individual access to your project.

About project access

Admins of organization-level projects can manage access for the entire organization, for teams, for individual organization members, and for outside collaborators.

Admins of user-level projects can invite individual collaborators and manage their access.

Project admins can also control the visibility of their project for everyone on the internet. For more information, see "Managing the visibility of your projects."

Managing access for organization-level projects

Managing access for everyone in your organization

The default base role is write, meaning that everyone in the organization can see and edit your project. To change project access for everyone in the organization, you can change the base role. Changes to the base role only affect organization members who are not organization owners and who are not granted individual access.

  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. Under Base role, select the default role. Screenshot showing the base role menu
    • No access: Only organization owners and users granted individual access can see the project. Organization owners are also admins for the project.
    • Read: Everyone in the organization can see the project. Organization owners are also admins for the project.
    • Write: Everyone in the organization can see and edit the project. Organization owners are also admins for the project.
    • Admin: Everyone in the organization is an admin for the project.

Managing access for teams and individual members of your organization

You can also add teams, external collaborators, and individual organization members as collaborators for an organization-level project. For more information, see "About teams."

You can only invite an individual user to collaborate on your organization-level project if they are already a member of the organization or an outside collaborator on at least one repository in the organization.

  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. Under Invite collaborators, search for the team or individual user that you want to invite. Screenshot showing searching for a collaborator
  6. Select the role for the collaborator. Screenshot showing selecting a role
    • Read: The team or individual can view the project.
    • Write: The team or individual can view and edit the project.
    • Admin: The team or individual can view, edit, and add new collaborators to the project.
  7. Click Invite. Screenshot showing the invite button

Managing access of an existing collaborator on your project

  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. Under Manage access, find the collaborator(s) whose permissions you want to modify.

    You can use the Type and Role drop-down menus to filter the access list. Screenshot showing a collaborator

  6. Edit the role for the collaborator(s). Screenshot showing changing a collaborator's role

  7. Optionally, click Remove to remove the collaborator(s). Screenshot showing removing a collaborator

Managing access for user-level projects

Granting a collaborator access to your project

This only affects collaborators for your project, not for repositories in your project. To view an item on the project, someone must have the required permissions for the repository that the item belongs to. If your project includes items from a private repository, people who are not collaborators in the repository will not be able to view items from that repository. For more information, see "Setting repository visibility" and "Managing teams and people with access to your repository."

  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. Under Invite collaborators, search for the user that you want to invite. Screenshot showing searching for a collaborator
  6. Select the role for the collaborator. Screenshot showing selecting a role
    • Read: The individual can view the project.
    • Write: The individual can view and edit the project.
    • Admin: The individual can view, edit, and add new collaborators to the project.
  7. Click Invite. Screenshot showing the invite button

Managing access of an existing collaborator on your project

  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. Under Manage access, find the collaborator(s) whose permissions you want to modify.

    You can use the Type and Role drop-down menus to filter the access list. Screenshot showing a collaborator

  6. Edit the role for the collaborator(s). Screenshot showing changing a collaborator's role

  7. Optionally, click Remove to remove the collaborator(s). Screenshot showing removing a collaborator