---
title: "Permissions"
slug: "permissions"
abstract: "Overview of user group policies and permissions."
---
# Permissions

A [user group policy](https://doc.sitecore.com/ch/en/users/content-hub/user-group-policies.html "User group policies") contains rules that consist of:

- *Permissions*, which define access at the data level (on assets, content, or any data from another entity definition) or at the interface level (pages). They determine what a user can see or do. Permissions are defined on a target entity definition and are always positive. You cannot deny permissions using user group policies.
- *Conditions*, which determine how the permissions are applied and on which entities. Using conditions, you can apply permissions to specific entities in the entity definition instead of to the entire entity definition.

> [!note]
> For further advice about assigning user permissions, refer to the [Security](https://doc.sitecore.com/ch/en/users/content-hub/security.html "Security") best practices.

## Permissions list

The following table describes permissions. Which permissions are available depends on the entity you select when you define the rule.

| Permission | Description |
| --- | --- |
| *Read* | View any entity in the defined entity definition that fulfills the specified conditions. A user who does not have *Read* access on an entity is not able to see it in the user interface or in the API. For page content (asset, content, product, or any other entity) to be visible, a user must also have *Read* permission on these entities; otherwise, an empty page is displayed. Enabling this permission for a portal page allows the user to open the page. For content items, the *Read* permission must be granted for both *M.ContentVersion* and *M.Content*. |
| *Create* | Create new entities that correspond to the defined entity definition and fulfill the specified conditions. |
| *Update* | Modify existing entities that correspond to the defined entity definition and fulfill the specified conditions. The *Update* permission is validated against the current and future state of an asset. This means, for example, that if a user has the *Update* permission for the condition `M.AssetType: Poster` but not for `M.AssetType: Artwork` when they try to update the asset from *Poster* to *Artwork*, it will not be possible. The *Update* permission must be granted for both conditions. |
| *Delete* | Delete existing entities that correspond to the defined entity definition and fulfill the specified conditions. |
| *Lock* | Lock the original version of an asset when a draft version is created. |
| *UnlockAlways* | Unlock the original asset after the changes are published and the draft is deleted. |
| *Submit* | Submit assets that fulfill the specified conditions for review. This permission *does not* grant state flow permissions when transitioning from one state to another. |
| *DirectPublish* | Submit assets that fulfill the specified conditions directly and skip the approval workflow steps. |
| *Approve* | Approve assets that are under review and fulfill the specified conditions. |
| *DownloadOriginal* | Download the original rendition file for assets that fulfill the specified conditions. |
| *DownloadPreview* | Download a preview rendition file for assets that fulfill the specified conditions. |
| *RequestRestricted* | Download restricted assets. Restricted assets are assets that are protected by [digital rights management (DRM)](https://doc.sitecore.com/ch/en/users/content-hub/digital-rights-management.html). A download is only permitted for users who are assigned this permission and only after verifying that the intended use of the asset that the user declares matches with the usage right of the asset. |
| *Order* | Create a download order from any search result set. |
| *OrderRestricted* | Download restricted assets, including when the intended use is not approved. Restricted assets are those assets protected by [DRM](https://doc.sitecore.com/ch/en/users/content-hub/digital-rights-management.html). A download is only permitted for users with this permission even if the intended use of the asset that the user declares does not match with the usage right of the asset. |
| *AddVersion* | Create a new version of an asset or content item. |
| *CreateAnnotations* | Add [annotations](https://doc.sitecore.com/ch/en/users/content-hub/create-and-use-annotations.html) to entities. |
| *ReadAnnotations* | Read annotations on entities. |
| *CreatePublicLinks* | Create [public links](https://doc.sitecore.com/ch/en/users/content-hub/public-links.html) for assets that fulfill the specified conditions. |
| *ReadPublicLinks* | View asset public links. |
| *CreateDraft* | Create a draft of an approved entity in order to apply changes. This is useful, for example, when a user does not have *Update* permissions on entities but needs to be able to create a draft with changes to be validated and implemented. *CreateDraft* applies to digital content and not digital assets. Applies only to entity definitions that have the [draft functionality](https://doc.sitecore.com/ch/en/users/content-hub/create-a-draft.html) enabled. |
| *Archive* | [Archive assets](https://doc.sitecore.com/ch/en/users/content-hub/archive-assets.html) that fulfill the specified conditions. This permission does not give access to the archived assets. For this, you must assign *Read* permission on the *FinalLifeCycleStatus* entity definition. |
| *ViewNotWatermarked* | See any rendition of an asset that fulfills the specified conditions without [watermarks](https://doc.sitecore.com/ch/en/users/content-hub/watermarking.html). |
| *ViewFileHistory* | View asset alternative files. |
| *ViewDataHistory* | View the **Technical log** of [the **Entity History** component](https://doc.sitecore.com/ch/en/users/content-hub/entity-history.html). This permission is also required to use the [Analytics entity operation](https://doc.sitecore.com/ch/en/users/content-hub/operations.html). |
| *CreateDiscussion* | [Create comments](https://doc.sitecore.com/ch/en/users/content-hub/add-comments.html) on entity details pages. |
| *Reassign* | Reassign [project](https://doc.sitecore.com/ch/en/users/content-hub/project-types.html) tasks. |
| *EntityPrint* | Generate a PDF from single or multiple entities based on a predefined print template. |
| *CreateUserRendition* | Create and configure renditions for an asset. |
| *DownloadUserRendition* | Download asset renditions. |
| *ShareViaEmail* | Share assets using emails. |
| *ContentPublishing* | Publish content to the delivery API. |
| *OverrideStateFlowGate* | [Approve or reject a stage](https://doc.sitecore.com/ch/en/users/content-hub/parallel-and-sequential-approvals.html#user-permissions-for-parallel-and-sequential-approvals), respond on behalf of a reviewer, or restart the review cycle. |
| *ManageStateFlowGate* | [Configure parallel and sequential approvals](https://doc.sitecore.com/ch/en/users/content-hub/parallel-and-sequential-approvals.html#user-permissions-for-parallel-and-sequential-approvals). |
| *ContentVersionHistoryConfiguration* | Use the **View version history** operation for content. Available as an *M.Setting* entity in the *M.Builtin.CMP.Everyone* user group policies. |
| *AllowEmptyOnDirectLinksUpdate* | Controls whether *Write* permissions are matched when entity links are empty. By default, this flag is set to *true*, meaning that *Write* permissions will not be granted if the links are empty. Users with the *ModifyPolicies* privilege can disable this flag for specific policy rules via the [REST API](https://doc.sitecore.com/ch/en/developers/cloud-dev/rest-apis.html) if needed. |

> [!note]
> You do not need specific permissions to download preview and thumbnail renditions.

## Permissions by operation

The following table lists Content Hub operations with the permissions required to use them.

| Operation | Permissions required |
| --- | --- |
| Add new version button to upload new file or new thumbnail | <ul><li>*Read*</li><li>*Create*</li><li>*Update*</li></ul><br><br>To have a new version button and to be able to upload a new version or an alternative thumbnail, these permissions must be configured on the `M.Asset` and the `M.File` entity definitions. |
| [Annotations](https://doc.sitecore.com/ch/en/users/content-hub/annotate.html) | <ul><li>*CreateAnnotations*</li><li>*ReadAnnotations*</li></ul> |
| [Custom renditions](https://doc.sitecore.com/ch/en/users/content-hub/custom-download-parameters.html) | <ul><li>*DownloadOriginal*</li><li>*CreateUserRenditions*</li></ul> |
| Delete | <ul><li>*Delete*</li></ul> |
| Detach from original | <ul><li>*Update* to save a variant as a standalone entity.</li></ul> |
| Downloads | <ul><li>*DownloadOriginal*</li><li>*DownloadPreview*</li></ul> |
| Drafts | <ul><li>*CreateDrafts*</li><li>*Delete* to discard a draft</li></ul> |
| Duplicate | <ul><li>*Create*</li></ul> |
|[Import content data](https://doc.sitecore.com/ch/en/users/content-hub/import-excel-data.html#import-the-content-data) | <ul><li>*Read*</li><li>*Create*</li><li>*Update*</li><li>*Delete*</li></ul> |
| Localize | <ul><li>*Create* to adapt content or campaigns to a defined language.</li></ul> |
| Preview (without watermark) | <ul><li>*DownloadPreview*</li><li>*ViewNotWatermarked*</li></ul> |
| Restore archived asset | <ul><li>*Update* for assets in the *Approved* lifecycle state.</li><li>*Archive*</li></ul> |
| Save as new | <ul><li>*Update*</li><li>*CreateDraft* to save an entity as a new version.</li></ul> |
| Share (through email) | <ul><li>*ShareViaEmail*</li></ul> |
| [Stateflows](https://doc.sitecore.com/ch/en/users/content-hub/create-a-state-flow.html) | <ul><li>*Update* on the target entity.</li><li>*Reassign* for task assignment.</li></ul> |
| User renditions | <ul><li>*CreateUserRendition*</li><li>*DownloadUserRendition*</li></ul> |