Authoring your Content Fragments is focused on both headless delivery and page authoring.
There are two editors available for Content Fragments. The editor described in this section:
This editor provides:
The editor described in this section is only available in the online Adobe Experience Manager (AEM) as a Cloud Service.
When you first open the Content Fragment Editor, you see four main areas:
top toolbar: for key information, and actions
a link to the Content Fragment Console (Home icon)
information about the model, and folder
an option to show all Parent References (link icon)
the fragment Status, and last saved information
a toggle to switch to the original (Assets-based) editor
The original editor opens in the same tab. It is not recommended to have both editors open at the same time.
left panel: shows the Variations for the Content Fragment, and its Fields:
central panel: shows the actual fields, and content, of the selected variation
Depending on definitions in the underlying model, fields can be subject to certain types of Validation.
A single Content Fragment;
Consists of two levels:
Can contain a variety of references.
In the left panel you can see:
In various parts of the editor you can see the link icon. This can be used to open the item shown; for example a Content Fragment Model, a Parent Reference, or a fragment being referenced:
Open the Structure tree tab from the editor toolbar to show the hierarchical structure of the Content Fragment, and its references. Use the link icons to navigate to the references.
See Analyzing Content Fragment Structure - Structure tree for more details.
With every update that you make, the Content Fragment is automatically saved. The last time saved is shown in the top toolbar.
Variations are a significant feature of AEM’s Content Fragments. They allow you to create and edit copies of the Main content for use on specific channels, and scenarios, making headless content delivery and page authoring even more flexible.
From the editor you can:
Create variations of the Main content
Select the required variation for editing the content
To create a Variation of your Content Fragment:
In the left panel, select the plus sign (Create variation) that is to the right of Variations.
After creating your first variation, existing variations will be listed in the same panel.
In the dialog, enter a Title for your variation, and a Description if wanted:
Create the variation. It appears in the list.
To rename a Variation:
Select the required variation.
Open the Properties tab in the right panel.
Update the variation Title.
Either press Return or move to another field to auto-save the change. The title is updated in the Variations panel on the left.
To delete a Variation of your Content Fragment:
You cannot delete Main.
Select the Variation.
In the Variation panel, select the delete icon (Trash Can):
A dialog opens. Select Delete to confirm the action.
Multi line text fields can have one of three formats:
Fields that are defined as either Plain Text or Markdown have a simple text box, without (on-screen) formatting options:
For Multi line text fields that are defined as Rich Text, various features are available:
Multi line text fields are also indicated by the appropriate icon in the Fields panel.
The full-screen editor offers the same editing options as when in-flow - but offers more space for the text.
The action Statistics displays a range of information about the text in a Multi line field.
The action Compare is available for Multi line fields when you have a Variation open.
This opens the Multi line field in full-screen and:
displays the content for both Main and the current Variation in parallel, with any differences highlighted
differences are indicated by color:
provides the Sync action, which synchronizes the content from Main to the current variation
Synchronization is only available to copy changes from Main to the variation.
Transferring changes from a variation to Main is not available as an option.
For example, a scenario where the variation content had been completely rewritten, so a synchronization will replace that new content with the content from Main:
Fragment References can be used to:
To create a reference to an existing Content Fragment:
Select the field.
Select Add existing fragment.
Select your required fragment from the fragment selector.
You are allowed to select only one fragment at a time.
Alternatively you can select Create new fragment to open the Create dialog. Once created, this fragment will be referenced.
Content References are used to reference other AEM content types, such as images, pages, and Experience Fragments.
In Content Reference fields you can both:
reference assets that already exist in the repository
upload them directly to the field; this avoids the need to use the Assets console to upload
To directly upload an image to the Content Reference field, it must:
To add an asset, you can either:
drag and drop the new asset file directly (for example, from your file system) into the Content Reference field
use the Add asset action, then select either Browse Assets or Upload to open the appropriate selector for you to use:
To add references to AEM pages, Experience Fragments, or other content types:
Select Add content path.
Add the required path in the input field.
Confirm with Add.
Selecting the link icon in the top toolbar opens a list of all parent references.
A window opens, listing all related references. To open a reference, select the name or title, or the link icon.
In the properties tab of the right panel, properties (metadata) and tags can be viewed. The properties can be either:
In the properties tab (right panel) you can also edit:
Tags: using the drop-down list, or the selection dialog
When you have Main selected, the name of the underlying Content Fragment Model is shown in the properties section. Selecting the link icon, opens the model in a separate tab.
In the Version history tab of the right panel, details of the current, and previous, versions are shown:
A new version is created when the content fragment is published.
You can revert to any version.
To revert to a specific version:
Select the three dots icon next to the version.
In the Language properties tab details of any related language copies are shown. Selecting a link icon, opens the copy in a separate tab.
For more details about translating a Content Fragment, and creating language copies, see the AEM Headless Translation Journey.
The Content Fragment editor provides authors with the option to preview their edits in an external frontend application.
To use this feature, you first need to:
When the URL has been defined, the Preview button is active. You can select this button to launch the external application (in a separate tab) to render the Content Fragment.
You can Publish your fragment to either your:
You can publish your fragment from either the editor, or the console. See Publishing and Previewing a Fragment for full details.
You can also Unpublish your fragment from either your:
You can unpublish your fragment from either the editor, or the console. See Unpublishing a fragment for full details.
The Fields panel lists all fields within the Content Fragment. The icon indicates the Data Type:
Single line text
Multi line text
Date and time
Although not represented by an actual icon, a Tab Placeholder is represented in the left panel.
To edit a Content Fragment you need the appropriate permissions. Contact your system administrator if you are experiencing issues.
For example, if you do not have
edit permissions the editor will be read-only.
A Content Fragment Model can often define data fields named Title and Description. If these fields exist, they are user-defined fields and can be updated in the central panel when editing the fragment.
The Content Fragment, and its variations, also have metadata fields (Variation properties) called Title and Description. These fields are an integral part of any Content Fragment and initially defined when the fragment. They can be updated in the right panel when editing the fragment.
See the Assets documentation for full information about the original Content Fragment editor - it is available from both the Assets console and the Content Fragments console.
Your project team can customize the editor if necessary. See Customizing the Content Fragment Console and Editor for further details.