A permission is an authorization granted to a user to perform particular operations. Permissions are granted to a user within a role, but not directly.
A role is a set of permissions which defines the level of access for a user to particular functionality and operations.
All permissions are divided into two categories:
Global permissions are granted within YouTrack's global scope and do not depend on a specific project.
When we say 'granted within YouTrack' we mean that permission does not make sense being granted for a particular project.
For example, you cannot allow someone to create users in a single project, you can do it only in the system-wide scope.
Global permissions are marked with the globe icon () in the list of permissions.
Per-project permissions are granted for a specific project. Read Project or Read User Group are examples of such permissions.
Even though we say that 'permissions are granted' globally or per-project, keep in mind that permissions are granted only as a part of a role and never directly as an individual permission.
The following permissions are grouped by the entity that they provide access to in YouTrack.
Issue
Permission
Description
Create Issue
Create a new issue.
Delete Issue
Delete issues.
Link Issues
Set relationships between issues.
Read Issue
View issues (public fields only).
Read Issue Private Fields
View private fields of an issue.
Update Issue
Update the public fields of an issue.
Update Issue Private Fields
Update private fields of an issue.
Update Watchers
Set another user as a watcher for an issue.
View Voters
View the list of users who have voted for an issue (available in full issue view).
View Watchers
View the list of users who are watching an issue (available in full issue view).
IssueAttachment
Permission
Description
Add Attachment
Attach files or screenshots to issues.
Delete Attachment
Delete files attached to issues.
Update Attachment
Modify files attached to issue and modify attachment visibility.
IssueComment
Permission
Description
Create Comment
Add a comment to an issue.
Delete Comment
Delete own comments.
Delete Not Own and Permanent Comment Delete
Delete comments posted by other users.
Read Comment
View issues comments.
Update Comment
Edit own comments.
Update Not Own Comment
Edit comments posted by other users.
IssueWorkItem
Permission
Description
Read Work Item
View the list of work items in an issue.
Update Not Own Work Item
Edit work items created by other users.
Update Work Item
Add and edit work items to an issue.
User
Permission
Description
Delete User
Delete User accounts in YouTrack.
UserProfile
Permission
Description
Read Not Own Profile
View profile of any user.
Update Not Own Profile
Edit the profile of any user. Allows editing and deleting any tag and saved search on the profile page of a user.
WatchFolder
Permission
Description
Create Tag, Saved Search or Report
Create a tag, saved search or report.
Delete Tag or Saved Search
Delete own tag or saved search.
Edit Tag or Saved Search
Edit own tag or saved search. Allows editing shared tag or saved search if user belongs to shared group.