Customizable fragments customizable-fragments

When fragments are used in a campaign or journey action, they are locked by default due to inheritance. This means any changes made to a fragment are automatically propagated to all campaigns and journeys where the fragment is used. With customizable fragments, specific fields within a fragment can be defined as editable when the fragment is added to a campaign or journey action. For example, suppose you have a fragment with a banner, some text, and a button. You can designate certain fields, such as the image or button target URL, as editable. This allows users to modify these elements when they incorporate the fragment into their campaign or journey, providing a tailored experience without affecting the original fragment.

Customizable fragments eliminate the need to break fragment inheritance, which previously stopped centralized changes at fragment level from being propagated to the campaigns and journeys. This approach allows content portions to be adjusted at the time of use, offering the flexibility to override default values with context-specific details.

By leveraging customizable fragments, you can efficiently manage and personalize your content without creating entirely new content blocks or disrupting the inheritance from the original fragment. This ensures that changes made at the fragment level are still propagated, while allowing for necessary customization at the campaign or journey level.

Both visual and expression fragments can be marked as customizable. For detailed instructions on how to proceed with each type of fragment, refer to the sections below.

Add editable fields in visual fragments visual

To make portions of a visual fragment editable, follow these steps:

Add editable fields in HTML components and expression fragments expression

To make portions of an HTML component or an expression fragment editable, you must use a specific syntax in the expression editor. This involves declaring a variable with a default value that users can override after adding the fragment to their content.

For example, suppose you want to create a fragment to add to your emails, and allow users to customize a specific color used in different locations, such as frames or buttons’ background colors. When creating your fragment, you need to declare a variable with a unique ID, for example “color”, and call it at the desired locations in the fragment content where you want to apply this color. When adding the fragment to their content, users will be able to customize the color used wherever the variable is referenced.

For HTML components, only specific elements can become editable fields. Expand the section below for more information.

To declare a variable and use it in your fragment, follow these steps:

When adding the fragment to their email content, users can now override the variables’ default values with their chosen values:

Editable expression fragment example  example

In the example below, we are creating an expression fragment presenting new sports collections. By default, the fragment displays this content: Looking for more? Don’t miss our latest sports collection!

We want to allow users to replace “sports” in this content with the sport of their choice. For example: Looking for more? Don’t miss our latest yoga collection!

To do so: