Managing access to projects (beta)

You can control who can view, edit, or manage your projects.

Note: Projects (beta) is currently in public beta and subject to change.

About project access

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

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. Click to access the project settings.
  3. Click Manage access.
  4. Under Base role, select the default role.
    • 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, and individual organization members, as collaborators. For more information, see "About teams."

You can only invite an individual user to collaborate on your organization-level project if they are a member of the organization.

  1. Navigate to your project.
  2. Click to access the project settings.
  3. Click Manage access.
  4. Under Invite collaborators, search for the team or organization member that you want to invite.
  5. Select the role for the collaborator.
    • 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.
  6. Click Invite.

Managing access of an existing collaborator on your project

  1. Navigate to your project.

  2. Click to access the project settings.

  3. Click Manage access.

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

  5. Edit the role for the collaborator(s) or click to remove the collaborator(s).

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. Click to access the project settings.
  3. Click Manage access.
  4. Under Invite collaborators, search for the user that you want to invite.
  5. Select the role for the collaborator.
    • 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.
  6. Click Invite.

Managing access of an existing collaborator on your project

  1. Navigate to your project.

  2. Click to access the project settings.

  3. Click Manage access.

  4. Under Manage access, find the collaborator(s) whose permissions you want to modify.

    You can use the Role drop-down menu to filter the access list.

  5. Edit the role for the collaborator(s) or click to remove the collaborator(s).

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.