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:
-
Create your own fragments. You can create visual fragments or expression fragments. Learn more
-
Use them as many times as needed in your content. See Add visual fragments and Leverage expression fragments
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
In this version, the following limitations apply:
-
Visual fragments are only available for the Email channel
-
Expression fragments are not available for the Web and In-app channels
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
-
Copy a fragment to another sandbox.
-
Archive a fragment. Learn more
-
Edit a fragment’s tags.
Edit fragments edit-fragments
To edit a fragment, follow the steps below.
-
Click the desired item from the Fragments list.
-
From the fragment properties, you can explore references, manage its access, and update the fragment details including tags.
-
Select the corresponding button to edit content as you would do when creating a fragment from scratch. Learn more
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.
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.
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:
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.
-
Access the fragment list through the Content Management > Fragments left menu.
-
Select Create fragment.
-
Fill in the fragment details, i.e. name and description (if needed).
-
Select the fragment type: Visual fragment or Expression fragment.
-
To assign custom or core data usage labels to the fragment, select Manage access. Learn more on Object Level Access Control (OLAC).
-
Select or create Adobe Experience Platform tags from the Tags field to categorize your fragment for improved search. Learn more
-
Click Create.
Create a visual fragment create-visual-fragment
-
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. -
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. -
Once your fragment is ready, click Save. It is added to the fragment list.
-
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
-
Create a fragment from the Content Management > Fragments left menu and select the Expression fragment type.
-
Select the type of code you want to use: HTML, JSON or Text.
-
Click Create. The Expression editor opens.
-
You can leverage the Journey Optimizer Expression editor with all its personalization and authoring capabilities. Learn more
-
Once your fragment is ready, click Save. It is added to the fragment list.
-
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.
-
In the Email Designer, click the ellipsis on top right of the screen.
-
Select Save as fragment from the drop-down menu.
-
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. -
Click Create. Fill in the fragment details, i.e. name and description (if needed).
-
To assign custom or core data usage labels to the fragment, select Manage access. Learn more on Object Level Access Control (OLAC).
-
Select or create Adobe Experience Platform tags from the Tags field to categorize your template for improved search. Learn more
-
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
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.
-
In the Expression editor interface, build an expression, then click Save as fragment.
-
In the right pane, enter a name and a description for the expression to help users find it more easily.
-
Click Save fragment.
-
The expression fragment is added to the fragment list. You can now use it to build personalized content.
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.