Skip to main content

Project (classic) permissions for an organization

Organization owners and people with classic project admin permissions can customize who has read, write, and admin permissions to your organization’s classic projects.

Notes:

  • Projects, the all-new projects experience, is now available. For more information about Projects, see "About Projects" and for information about migrating your classic project, see "Migrating from projects (classic)."
  • You can only create a new classic project board for an organization or user that already has at least one classic project board. You cannot create new classic projects for repositories. If you're unable to create a classic project board, create a project instead.

Permissions overview

There are three levels of permissions to a classic project for people and teams:

  • Read, which gives people permission to view a classic project.
  • Write, which gives people permission to view a classic project, link repositories to a classic project, and interact with a classic project. For more information, see "Linking a repository to a project (classic)."
  • Admin, which gives people permission to view a classic project, interact with a classic project, manage classic project settings, and manage other people's access to the classic project.

Organization owners and people with admin permissions can give a person access to an organization classic project individually, as an outside collaborator or organization member, or through their membership in a team or organization. An outside collaborator is someone who is not an organization member but given permissions to collaborate in your organization.

Organization owners and people with admin permissions to a classic project can also:

Cascading permissions for classic projects

If a person has multiple avenues of access to an organization classic project (individually, through a team, or as an organization member), the highest classic project permission level overrides lower permission levels.

For example, if an organization owner has given all organization members read permissions to a classic project, and a classic project admin gives an organization member write permissions to that board as an individual collaborator, that person would have write permissions to the classic project.

Classic project visibility

Organization owners can control the ability of organization members to create public projects and classic projects, or change the visibility of existing projects and classic projects to public. For more information, see "Allowing project visibility changes in your organization."

By default, user-owned and organization-wide classic projects are private and only visible to people with read, write, or admin permissions to the classic project. A public classic project is visible to anyone with the classic project's URL. Repository-level classic projects share the visibility of their repository. That is, a private repository will have a private project, and this visibility cannot be changed. You can change the classic project's visibility from private to public and back again. For more information, see "Changing project (classic) visibility."

Further reading