DocumentationAEM as a Cloud ServiceUser Guide

Content Fragments - Delete Considerations content-fragments-delete-considerations

Last update: Fri Nov 17 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Review these important considerations before defining your Content Fragments deletion policies in AEM. Content Fragments are a powerful tool for delivering headless content, and the implications of deleting them must be carefully considered.

Permissions - Delete or Not Delete permissions-delete-or-not-delete

The ability to delete content is powerful, but potentially sensitive, with many industries needing to restrict and control how these privileges are distributed.

In relation to delete permissions, Content Fragments must be considered at two levels:

  1. The Content Fragment as a single entity.

    • Use case: A user who must edit/update a content fragment - and delete an entire fragment.
    • Permissions: The Delete permission can be assigned through User and/or Group Management.

  2. The multiple sub-entities that make up a content fragment; for example, variations, sub-nodes.

    Basic operation of the content fragment editor requires that such transient sub-elements can be deleted. For example, when manipulating variations; also when editing metadata or managing associated content.

NOTE
When a user does not have any Delete permissions, the Content Fragment editor operates in read-only mode.
NOTE
See also How to Audit User Management Operations in AEM.

Permissions Required for Editor Functionality Only permissions-required-for-editor-functionality-only

For users that need to edit/update a content fragment, without allowing them to delete an entire fragment, specific permissions must be assigned, as basic operation of the content fragment editor requires that transient sub-elements can be deleted.

For example, when manipulating variations; also when editing metadata or managing associated content.

NOTE
The delete permissions, required to edit/update a Content Fragment, are included in the Delete permission assigned through User and/or Group Management.

The permissions needed to edit/update a fragment need to be applied to either the node containing the content fragment, or an appropriate parent node (at any level under /content/dam). When assigned to such a parent node, the permissions are applied to all nodes within that branch.

For example, a folder that will hold all content fragments, such as:

  • /content/dam/contentfragments
CAUTION
Setting the permissions on /content/dam is also possible, as all content fragments are stored here.
However this action applies the same delete permissions to all other asset types as well.

The permissions prerequisite to allowing a specific user and/or group to edit/update a content fragment are:

NOTE
This list shows all the privileges required, not just the delete privileges.

  • For the Content Fragment nodes or folders:

    • jcr:addChildNodes, jcr:modifyProperties

  • For the jcr:contentnode of all Content Fragments:

    • jcr:addChildNodes, jcr:modifyProperties and jcr:removeChildNodes

  • For all nodes below jcr:content of all Content Fragments:

    • jcr:addChildNodes, jcr:modifyProperties and jcr:removeChildNodes, jcr:removeNode
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab