Fragments
A fragment is a reusable component that can be referenced in one or more emails and email templates across Adobe Journey Optimizer B2B Edition. It is usually a block of content (text, image, or both) that can be pre-created and quickly inserted into an email or email template. With this functionality, you can prebuild multiple custom content blocks that can be used by your marketing team members to assemble email contents for an improved design process. Common use cases include header/footer content blocks for email, event invite banners, and seasonal greetings.
To make the best use of fragments in your workflows:
- Create your own fragments - Create visual fragments, either from scratch or by saving content as fragment anytime from the visual content editor.
- _Reuse your fragment_s - Use them as many times as needed in your content.
Visual fragments
Visual fragments are pre-defined visual blocks built using the visual content editor that you can reuse across multiple emails or email templates. The current scope of Journey Optimizer B2B Edition and this documentation are that of visual fragments only. Expression-based fragments are not yet supported in Journey Optimizer B2B Edition.
Access and manage fragments
To access visual fragments in Adobe Journey Optimizer B2B edition, go to the left navigation and click Content Management > Fragments. This action opens a listing page with all the fragments created in the instance listed in a table.
The table is sorted by the Modified column, with the most recently updated fragments at the top of the list by default. Click the column title to change between ascending and descending.
Search for any fragment by entering a text string into the search bar for a match by fragment name. Click the Filter icon to filter the displayed items according to your specified criteria.
Customize the columns that you want to display in the table by clicking the Customize table icon on the top right. Select the columns to display and click Apply.
Create fragments
You can create new visual fragments in Journey Optimizer B2B Edition by clicking Create fragment at the top right.
-
In the Create fragment dialog, enter a useful Name and Description (optional).
Fragment requirements:
-
Name - Maximum of 100 characters, must be unique, case-insensitive
-
Description - Maximum of 300 characters
-
Alpha, numeric, special characters are allowed
-
Reserved characters are not allowed:
\ / : * ? " < > |
-
-
Click Create.
The visual content editor opens with an empty canvas. For building a fragment using the visual content editor, refer to the content authoring topics:
View fragment details
Click the name of any fragment in the list page to open the fragment details page.
From here you can choose to edit the fragment, rename the fragment or update the fragment description (make updates and click outside the name/ description box to auto-save changes).
Click Edit to open the fragment in the visual content editor.
Exit the view at any time by clicking the Back arrow at the top left, which returns you to the Fragments list page.
View fragment used-by references
Within the fragment details page, click the Used By tab to view details of where the fragment is currently used within Journey Optimizer B2B Edition, across emails, email templates, and fragments.
References are displayed according to category: Email or Email template. Emails in Journey Optimizer B2B Edition are embedded and authored within account journeys, so the parent journey of the email that uses the fragment is displayed in references.
Click the link to open the corresponding email or email template where the fragment is used.
Delete fragments
Any fragment that is currently in use by any email or email template cannot be deleted, so ensure that you check the used-by references before initiating a fragment removal. Also, a removal cannot be undone, so check before initiating a delete action.
You can delete a fragment using either of the following methods:
- From the fragment details on the right, click Delete.
- From the Fragments listing page, click the ellipsis next to the fragment and choose Delete.
This action opens a confirmation dialog. You can abort the process by clicking Cancel, or click Delete to confirm deletion.
If the fragment is currently in use, the action opens an informational dialog that alerts you that it cannot be deleted. Click OK, which aborts the deletion.
Edit fragments
You can edit a fragment using either of the following methods:
- From the fragment details on the right, click Edit.
- From the Fragments listing page, click the ellipsis next to the fragment and choose Edit.
This action opens the fragment in a visual content editor, where you can edit the fragment using any of the features for creating a fragment.
Duplicate fragments
You can duplicate a fragment using either of the following methods:
- From the fragment details on the right, click Duplicate.
- From the Fragments listing page, click the ellipsis next to the fragment and choose Duplicate.
In the dialog, enter a useful name (unique) and description. Click Duplicate to complete the action.
The duplicated (new) fragment then appears in the Fragments listing.
Save a fragment from the email or template editor
Any time that you are in the visual content editor for creating/editing an email or email template, you can choose to save all or parts of the content as a fragment so that it is available for reuse.
-
When you have some content to be saved as a fragment, click More and choose Save as Fragment.
-
Select the different elements to be included in the fragment.
Select multiple structures by holding the CTRL button
You can only select structures that are adjacent to each other and the interface does not allow you to select non-adjacent elements.
-
With the content selected, click Create at the top right.
-
In the dialog, enter a useful name and description for the fragment. Then click Create.
The new fragment is then displayed in the Fragments listing page and is also available for use within emails and email templates.
Add visual fragments to an email or template
Fragments are deigned for reuse and can be inserted for email and email template authoring. You can add up to 30 fragments in a given email or template. Fragments can be nested up to one level only.
-
Navigate to Account Journeys and open an existing journey or create a new journey.
-
Create a ‘Take an action > People action > Send Email’ node.
-
Create or edit email content for the node.
-
Drag and drop an item from the Components menu to provide a structure for the fragment.
-
To open the fragments listing, click the Fragments icon.
You can:
- Sort the listing.
- Browse, Search, Filter the listing.
- Switch between Thumbnail and List views.
- Refresh the list to reflect any of the recently created fragments.
-
Drag and drop any of the fragments into the structure component placeholder.
The editor renders the fragment within the section/element of the email structure.
The content of the fragment is dynamically updated within the structure to render a visual of how the content appears in the email.
If you want to add the fragment so that it occupies the entire horizontal layout within the email, add a 1:1 column structure and then drag and drop the fragment into it.
After the email is saved, it appears in the fragment details page > Used By section. Fragments added to an email are not editable within the email – the content is defined by the source fragment.
-
From the left navigation, click Content Management > Templates.
-
Create a new template, or open an existing email template and click Edit Email Template.
-
Drag and drop an item from the Components menu to provide a structure for the fragment.
-
To open the fragments listing, click the Fragments icon.
You can:
- Sort the listing.
- Browse, Search, Filter the listing.
- Switch between Thumbnail and List views.
- Refresh the list to reflect any of the recently created fragments.
-
Drag and drop any of the fragments into the structure component placeholder.
The editor renders the fragment within the section/element of the email template structure.
-
Drag and drop any of the fragments into the structure component placeholder.
The editor renders the fragment within the section/element of the email template structure.
If you want to add the fragment so that it occupies the entire horizontal layout within the email template, add a 1:1 column structure and then drag and drop the fragment into it.
After the email template is saved, it appears in the fragment details page > Used By section. Fragments added to an email template are not editable within the template – the content is defined by the source fragment.
Fragment actions during authoring
After a fragment is added to an email or email template, the fragment content cannot be edited within the email or template. However, you can apply the following actions:
- Delete - This action removes the fragment from the current email or email template content (the fragment source is unaffected).
- Refresh - This action refreshes the content of the fragment in the current email or email template. This is useful when you want to reflect any recent edits to the fragment after it was added to the email or email template.
- Duplicate - This action duplicates the fragment within the same email or email template within the editor, with the same dimensions and added just below it.
- Open Fragment - This action opens a new browser tab with the fragment editor page and details.
- Break inheritance - This action breaks the inheritance of the fragment (and its changes) from the source. Use this action to make the fragment content available as independent and editable content within the email or email template. This action also removes the email or email template from the Used By reference for the original fragment.
When you select the fragment on the editor page, these actions are available from the context toolbar and the properties panel on the right.