Protect content from master content changes

Components within a live copy page are marked with an extra icon: . This helps you to differentiate between live copy content and unlinked content.

You may not want all the content in your live copy pages to be overwritten when master changes are pushed. You can protect the content in whole pages, components or selected fields.

Full pages

To protect a full page, select the live copy page and click Disable updates from master.

The page is marked with an unlinked icon in the Pages app browser:

This breaks the link between the master and the live copy, but you can reattach it if you need to.

Components

To protect a component, edit the page, select the component, and click Disable updates from master.

The component bar changes to white and is marked with an unlinked icon:

When you disable updates from master, the component node is flagged with liveCopyReferenceDropped = true (visible to developers in the JCR Browser app) and the color of the component bar changes to white.

When you only protect some fields within a component, the propertiesToIgnore flag is set in the array of field names (visible to developers in the JCR Browser app) and the color of the component bar remains green.

In the case of complex components with many fields within fields, note that all the nodes are protected when updates are disabled from master.

For example, if a contact component has multiple fields and subfields as part of an address, the component node is locked and each individual field node is also locked to ensure they are not overwritten by content from the master:

/live-copy/multi-page/contact/0 — The component itself
/live-copy/multi-page/contact/0/multi0 — A complex field in the component
/live-copy/multi-page/contact/0/multi0/address — A subfield within the complex field

Fields in a component

To protect a field within a component, edit the component then click on the protect field icon next to the fields that should not be overwritten by your master content.

It is not possible to individually protect the inner fields of a composite field. For example, the single fields City and Country contained within the composite field depicted below cannot be protected individually. Only the composite field Location (with properties City and Country) is protected, as indicated by the red icon.

Likewise, the red icon in the screenshot below indicates that the field is not linked to the master content. It is protected. The grey and white icon indicates that the field is linked to the master content.

When only one or some of the fields in a component are locked, the propertiesToIgnore flag is set in the array of field names (visible to developers in the JCR Browser app) and the color of the component bar remains green.

For complex attributes, in addition to flagging the name of the attribute with propertiesToIgnore:

All child nodes are marked with the liveCopyReferenceDropped tag to ensure that they are not updated when pushing content from the master.
If the attribute uses the currentItemProvider provider type, all the attributes in the child components are added to the propertiesToIgnore array.

It is required to protect fields independently for every language defined. You can protect a field in one language and not another by switching the language and then clicking on the protect field icon.

If a complex field is already protected from a version earlier than 3.2.10, you must unprotect it and then protect it again to enable the new code introduced in that release.

Breaking and reattaching

You can break the link between the master and the live copy pages.

The linking of live copy pages to master content is done using a page property called masterContentIdentifier.

You can see this property in the JCR Browser or via content export.

To break this link:

Select a page and click Disable updates from master.
1. After confirmation, the page no longer receives updates from the master page.

What just happened?

Breaking the link to master content is achieved through a page property called liveCopyReferenceDropped. When this flag is set to true, the linking of content is turned off.

However, the masterContentIdentifier still remains and the content can be re-linked at any time. To reattach the live copy content to the master content, click Enable updates from master.