Work with fragments fragments

A fragment is a reusable component that can be referenced in one or more emails across Journey Optimizer campaigns and journeys.

This functionality allows to prebuild multiple custom content blocks that can be used by marketing users to quickly assemble email contents in an improved design process.

➡️ Learn how to manage, author and use fragments in these videos

To make the best use of fragments:

NOTE
Visual fragments can be used in the Email Designer, whereas expression fragments are accessible through the Expression editor.

In addition, you can leverage Journey Optimizer Content REST API to manage content fragments. For more on this, refer to the Journey Optimizer APIs documentation.

Before starting fragment-prerequisites

CAUTION
To create, edit, and archive fragments, you must have the Manage library items permission included in the Content Library Manager product profile. Learn more

In this version, the following limitations apply:

  • Visual fragments are only available for the Email channel

  • Expression fragments are not available for the In-app channel

Access and manage fragments access-manage-fragments

To access the fragment list, select Content Management > Fragments from the left menu.

All the fragments that were created on the current sandbox - either from the Fragments menu, either using the Save as fragment option - are displayed.

You can filter fragments on their:

  • Type: Visual or Expression
  • Tags
  • Creation or modification date

You can choose to show all fragments, or only the items that the current user created or modified.

You can also display the Archived fragments. Learn more

From the More actions button next to each fragment, you can:

  • Duplicate a fragment.

  • Use the Explore references option to see the journeys, campaigns or templates where it is used. Learn more

  • Archive a fragment. Learn more

  • Edit a fragment’s tags.

Edit fragments edit-fragments

To edit a fragment, follow the steps below.

  1. Click the desired item from the Fragments list.

  2. From the fragment properties, you can explore references, manage its access, and update the fragment details including tags.

  3. Select the corresponding button to edit content as you would do when creating a fragment from scratch. Learn more

NOTE
When you edit a fragment, the changes are automatically propagated to all contents using that fragment, except content used in Live journeys or campaigns. You can also break inheritance from the original fragment. Learn more in the Add visual fragments to your emails and Leverage expression fragments sections.

Explore references explore-references

You can display the list of the journeys, campaigns and content templates that are currently using a fragment.

To do so, select Explore references either from the More actions menu in the fragment list or from the fragment properties screen.

Select a tab to toggle between journeys, campaigns, templates and fragments. You can see their status and click a name to be redirected to the corresponding item where the fragment is referenced.

NOTE
If the fragment is used in a journey, campaign or template that has a label preventing you from accessing it, you will see an alert message on top of the selected tab. Learn more on Object Level Access Control (OLAC)

Archive fragments archive-fragments

You can clean the fragment list from the items that are no longer relevant to your brand.

To do so, click the More actions button next to the desired fragment and select Archive. It will disappear from the fragment list, which prevents users from using it in future emails or templates.

NOTE
If you archive a fragment that is used in a content, that content will not be affected.

To unarchive a fragment, filter on the Archived items and select Unarchive from the More actions menu. It is now again accessible from the fragment list, and can be used in any email or template.

Create fragments create-fragments

There are two ways you can create fragments:

  • Create a fragment from scratch, using the Fragments dedicated menu. Learn how

  • When designing content, save a portion of your content as fragment. Learn how

Once saved, your fragment is available for use in a journey, a campaign or a template. Whether created from scratch or from an existing content, you can now use this fragment when building any content within Journey Optimizer. See Add visual fragments and Leverage expression fragments

Create from scratch create-from-scratch

To create a fragment from scratch, follow the steps below.

  1. Access the fragment list through the Content Management > Fragments left menu.

  2. Select Create fragment.

  3. Fill in the fragment details, i.e. name and description (if needed).

  4. Select the fragment type: Visual fragment or Expression fragment.

  5. To assign custom or core data usage labels to the fragment, select Manage access. Learn more on Object Level Access Control (OLAC).

  6. Select or create Adobe Experience Platform tags from the Tags field to categorize your fragment for improved search. Learn more

  7. Click Create.

Create a visual fragment create-visual-fragment

  1. Create a fragment from the Content Management > Fragments left menu and select the Visual fragment type.

    note note
    NOTE
    Currently for visual fragments only the Email channel is supported.
  2. The Email Designer displays. Edit your content as needed, the same way you would do for any email inside a journey or a campaign.

    note note
    NOTE
    You can add personalization fields and dynamic content, but contextual attributes are not supported in fragments.

  3. Once your fragment is ready, click Save. It is added to the fragment list.

  4. If needed, click the arrow next to the fragment name to go back to the Details screen and edit it.

This fragment is now ready to be used when building any email or content template within Journey Optimizer. Learn how

Create an expression fragment create-expression-fragment

  1. Create a fragment from the Content Management > Fragments left menu and select the Expression fragment type.

  2. Select the type of code you want to use: HTML, JSON or Text.

  3. Click Create. The Expression editor opens.

  4. You can leverage the Journey Optimizer Expression editor with all its personalization and authoring capabilities. Learn more

  5. Once your fragment is ready, click Save. It is added to the fragment list.

  6. If needed, click the arrow next to the fragment name to go back to the Details screen and edit it.

This fragment is now ready to be used when building any content within the Journey Optimizer Expression editor. Learn how

Save as fragment save-as-fragment

When editing content in Journey Optimizer, you can save all or part of your content as fragment for future reuse.

Save as visual fragment save-as-visual-fragment

When designing a content template or an email in a campaign or a journey, you can save a portion of your content as visual fragment. To do this, follow the steps below.

  1. In the Email Designer, click the ellipsis on top right of the screen.

  2. Select Save as fragment from the drop-down menu.

  3. The Save as fragment screen displays. There select the elements you want to include into your fragment, including personalization fields and dynamic content. Note that contextual attributes are not supported in fragments.

    note caution
    CAUTION
    You can only select sections that are adjacent to each other. You cannot select an empty structure or another fragment.

  4. Click Create. Fill in the fragment details, i.e. name and description (if needed).

  5. To assign custom or core data usage labels to the fragment, select Manage access. Learn more on Object Level Access Control (OLAC).

  6. Select or create Adobe Experience Platform tags from the Tags field to categorize your template for improved search. Learn more

  7. Click Create again. The fragment is saved into added to the fragment list, accessible from the Journey Optimizer dedicated menu.

    It becomes a standalone fragment that can be accessed, edited and archived as any other item on that list.

You can now use this fragment when building any email or content template within Journey Optimizer. Learn how

NOTE
Any change to that new fragment is not propagated to the email or template it comes from. Similarly, when the original content is edited within that email or template, the new fragment is not modified.

Save as expression fragment save-as-expression-fragment

The Journey Optimizer Expression editor allows you to save content as expression fragments. These expressions are then available to build personalized content.

To save content as an expression fragment, follow the steps below.

  1. In the Expression editor interface, build an expression, then click Save as fragment.

  2. In the right pane, enter a name and a description for the expression to help users find it more easily.

  3. Click Save fragment.

  4. The expression fragment is added to the fragment list. You can now use it to build personalized content.

NOTE
Expressions cannot exceed 200KB.

How-to video video-fragments

Learn how to manage, author, and use visual fragments in Journey Optimizer.

Learn how to manage, author, and use expression fragments in Journey Optimizer.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76