Propagating Fragment Changes
By default, changes made to a custom fragment’s code are not propagated to deployed instances of the fragment. Using fragment propagation, you can propagate changes to fragment instances in one of two ways:
To avoid overwriting data, changes made to editable fields cannot be propagated to the fragment directly. However, you can force propagation by changing the fragment’s field ID. When propagated, the field’s content is no longer displayed, though you can retrieve its content from the database using the old field ID. To learn more, see Fragment Specific Tags and Attributes Reference in the developer documentation.
Manually Propagating Changes
-
Open the Site Menu (
) and go to Design → Fragments. -
Navigate to the Fragment Set for the desired fragment.
-
Click Actions (
) for the desired fragment and select View Usages.
TipIf the View Usages option is unavailable, the fragment is not in use.
-
In the Usages and Propagation page, check the fragment instances you want to update to the latest version.
In the table, you can review whether a page or template is using a Previous Version or the Latest Version.
-
Click Propagate (
) to update the selected instances of the fragment.
Changes made to non-editable fields are propagated automatically to the selected fragment instances.
Automatically Propagating Changes
Automatic propagation can lead to unintended consequences in the production environment, such as typos or inaccurate content being published. Use automatic propagation only for testing or development purposes.
-
Open the Global Menu (
), click the Control Panel tab, and go to Configuration → System Settings. -
Under the Content and Data section, click Page Fragments.
-
Check the Propagate Fragment Changes Automatically box.
-
Click Save.
When enabled, changes made to a fragment’s non-editable fields are propagated automatically to all instances of the fragment.