YouTrack Standalone 2018.3 Help

Private and Public Projects

YouTrack supports both private and public projects.

  • In a private project, access is restricted to a limited set of users and groups. You can hide a private project from all other users in the system.

  • In a public project, issues are visible to anonymous users over the internet.

The visibility for a project is affected by the status of the guest user account. By default, the guest account is banned. This means that all of your projects are private. If you want to expose a project to the public and let users browse issues anonymously, an administrator must unban the guest account.

If you want to have a mix of public and private projects, a system administrator needs to remove the roles that are assigned to the guest account in the Global project. Project administrators can then allow guest access on a per-project basis. For details, see Manage the Guest User Account.

Public Projects with Guest Access

By default, the guest user account is granted the Observer role in the Global project. This gives anonymous users the Read Issue and Read Comment permissions in all projects. These permissions let guest users view any issue and its comments in any project.

Even in projects that are accessible to guest users, you still have the ability to restrict the visibility of issues and comments on a per-issue basis. For more information, see Set Issue, Comment, and Attachment Visibility.

You also have the ability to mark specific fields as private and hide their values from users who don't have permission to read private fields, including anonymous users. For more information, see Private Custom Fields.

Privacy at the Project Level

As a project administrator, you can manage which users and groups have access to issues in your project. The following options are available on the Edit Project page:

  • On the Access tab, you can grant roles in the project to users and groups. This gives you fine-grained control over the level of access that is available to users in your project.

  • On the Team tab, you can add users and groups to the project team. This gives users the level of access that is defined by the default Developer role.

To ensure that your project is private:

  • Don't assign any roles to the guest account or add the guest user to the project team.

  • Avoid assigning roles to or granting team membership to the All Users group.

Privacy at the Global Level

Project access is also affected by roles assignments in the Global project. You'll find a list of roles that are assigned to users and groups in the Global project on the Access tab of the Edit Project page.

roles global project

To restrict project access exclusively to members of the project team and other users or groups who are assigned direct roles in the project, you'll need help from a system administrator. Here are some important operations that are available to users who are assigned the default System Admin role:

  • Restrict project access for anonymous users. A system administrator can remove roles that are assigned to the guest account in the Global project. Project administrators can then allow guest access on a per-project basis. For more information, see Manage the Guest User Account.

  • Remove unwanted role assignments in the Global project. It's common practice to assign roles to users and groups in the Global project to ensure that a handful of users can perform similar duties in all projects. You can check the set of permissions that are granted by these roles on the Access tab in your project. If you find that a particular role assignment in the Global project exposes a greater level of access than is required, discuss the setup with a system administrator. A system administrator can either update the permissions that are assigned to the role or revoke this level of access at the global level.

Last modified: 7 March 2019