Create content step-by-step
On this page we'll walk you through creating a new piece of content using a simple banner as an example. This will probably be very similar to some of the types of content that are installed in your library. Also included here is an example of creating a more complex content item, see Creating linked content.
Creating a simple bannerLink copied!
To create a new piece of content, click "Create content" in the top right of the content library window.
A content browser lets you pick the type of content that you want to create. The available content types for your current repository are set up by your developers. For this example we're going to create a Tutorial Banner by selecting the "Tutorial Banner" icon.
Use the search to help find the type of content that you want to create.
Once you've chosen a content type, a form opens with the necessary fields for creating content. Notice that the content type is shown at the top of the window, and in this example it's the Tutorial Banner.
Labels provide detail about the purpose of each field, in this case a headline, strapline and a background image. We'll fill in the heading and subheading and add the image.
To add the background image, click the "Add" button.
The Asset Library browser opens, showing the available images. In most cases your assets will be stored in the Amplience Content Hub linked to your hub, as is shown here.
To add an image hover the mouse over it and click "Add".
If you can't find an image that's quite right and Image Studio is enabled on your account, select an existing image and use Image Studio's AI capabilities to make it match your vision. More about Image Studio.
Our selected image is now included in the content.
With Image Studio enabled on your account you can edit images within your workflow.
Once all the fields have been populated, the content can be saved.
The Save content dialog is displayed. In this example we'll name the content "Summer collection banner". The name will be displayed when adding this content to slots in an edition, so when you create content items you will probably use some naming conventions to identify them with a particular project.
For more details about the options shown in the Save menu, see Saving content.
The content is now saved. If this content type has a visualization associated with it, then a preview of the content is shown in the window on the right hand side. The preview will show the content as it will appear when it's displayed on your website or app.
A visualization is refreshed each time you click Save.
Once you've finished editing the content, you can click the Back button to return to the Content Library.
The newly created content item is now shown in the Content Library. The content is sorted by last modified date, so our banner appears in the top left.
Editing images within your workflowLink copied!
If you have Image Studio enabled on your account you can use its AI capabilities to quickly edit images as part of your authoring workflow.
When Image Studio is enabled on your account, images in your authoring experience will display an "Edit in Image Studio" icon (as shown below).
For the example content above, we want to edit the banner image to give it more of a Summer look. This is a simple job using Image Studio, just launch the studio by hovering the cursor over the image and click "Edit in Image Studio". Image Studio is launched in a new browser tab.
The "Edit in Image Studio" icon is displayed when Image Studio is enabled on your account for images fields that do not have any additional customization. See How to get Image Studio.
To make our existing image look exactly how we want it, we're going to use Image Studio to:
For this example we need a banner for a surfing equipment Summer sale. We have an existing photo that includes a surfboard, but our existing image doesn't convey the Summer vibe that we want. There are no graphic designers available, and we have limited graphic design skills, so we're going to use Image Studio to edit the existing image to make it match our vision.
First we're going to replace the background:
Notice in the example above a "Save" button is shown. This is because Image Studio has been launched directly from content in Dynamic Content, allowing the edited image to be saved straight back into the content.
The new background gives more of a Summer feel to our banner, and we've applied a light blur effect to blend the foreground and background for a more natural look.
Now our banner has a light blur, we'll move the foreground slightly to the right by clicking and dragging it. You can also resize foreground layers. See Resizing and repositioning images.
Finally, we want to remove some imperfections from the shot by using Image Studio's Magic eraser.
To remove unwanted objects just draw a mask around them and then click "Magic erase".
With just a few clicks and no special graphics skills, we now have an image that's more suitable for our Summer sale banner.
Once the final edits are made in Image Studio, you can save them to a new file. Image Studio uses the existing file name with an appended number as the default name, or you can enter a new name. When you navigate back to your content in Dynamic Content, the new image is automatically loaded into your content.
The image that we edited is now included in our content.
Image Studio always creates a new image (appending a number to its name for uniqueness) and gives you the option to enter a different image name.
Creating and editing rich textLink copied!
Some of your content may be text based and include properties where you can enter rich text. There are two editors that can be used for editing rich text within the authoring experience, a built in, default rich text editor, and our Generative rich text editor. See Content text editors.
For help with common rich text formatting questions, see Creating content FAQs.
Creating linked contentLink copied!
In some cases you may need to create a content item with links to other items. For example, a carousel with multiple slides. These slides would be stored separately from the carousel itself and be reused in various content pieces.
Here we'll show you how to create linked content, using a simple carousel as an example.
To create the carousel, choose "Create content" from the top right of the content library window and choose "Carousel" from the content types window.
A new carousel is opened to which you can add slides by clicking the plus icon.
The "Add content" window lets you select existing content or create new content. In this example, we're selecting existing content to add to the carousel.
If you choose to "Create new content", the available content types are shown in the "Add content" window. In the example below, the carousel slide is the only type of content that can be linked to the carousel.
To make sure you link to the correct types of content, your developers set which types can be created from this window.
Once linked content has been added you are returned to the parent content. For this example the carousel now has linked slides and can be saved.
The carousel has now been saved. Because the carousel content type has a visualization associated with it, a preview of the carousel content appears in the window on the right.
Click the back button to return to the Content Library.
Adding a delivery keyLink copied!
As part of your workflow you may be required to add delivery keys for content, to provide a unique identifier for delivering content. Delivery keys must be between 1 and 150 characters and follow the delivery key validation rules.
To add a delivery key from the content library:
You can add a delivery key to a content item or slot from the content library, by choosing "Delivery key" from the contextual menu.
From the content library list view, you can also use the "+ Delivery key" shortcut, shown below:
To add a delivery key from the authoring experience:
From the authoring experience you can add a delivery key by choosing "Delivery key" from the Save menu (see 1 below).
Your authoring experience may be set up to include a delivery key field, in which case there'll be a field where you can enter a delivery key (see 2 below). Note, the delivery key field may be labeled with a different name, for example, "Slug", or "Page URL", depending on how your developers have set it up.
Use the schema editor to include a delivery key field on a content form.
Entering a valid delivery keyLink copied!
This example shows a delivery key being entered in the Delivery key dialog. Note, in this example, the content form itself has a delivery key field where the key could be entered.
When you save the delivery key, validation is applied. The delivery key must follow the system validation rules and an invalid key cannot be saved.
Delivery keys are case sensitive, so "home-page-banner" and "Home-page-banner" can both be entered as unique keys. If you have a naming convention in place, be sure to follow any capitalization that has been specified.
To save your changes after entering a delivery key in a content form field, all of the other form field values must be valid too.
An invalid delivery key, for instance one that starts with "/", prevents the content item or slot from being saved until the key is corrected.
Your system may perform additional validation on delivery keys. For example, to ensure naming conventions are followed. The required pattern is displayed in a message if the key is invalid. A developer can help you resolve this. See additional validation.
When a valid delivery key is saved, the properties pane shows the delivery key and the delivery key URL to get the item. You will need to publish the item before you can use the delivery URLs.
In this example, the content item can be retrieved using the following URL when the content item is published:
Finding a duplicate delivery keyLink copied!
When you add or change a delivery key, that key must be unique within the hub. If you try to save a delivery key that is already used by another content item or slot in the same hub, a message tells you that the duplicate key cannot be saved.
Here's an example of a duplicate key message shown in the Delivery key dialog. The "Edit this item" link enables you to easily locate and change the existing key, by taking you directly to the item or slot that already uses the delivery key.
To change or remove the existing delivery key, click 'Edit this item'. The content containing the key you want to change is displayed. Select 'Delivery key' from the Save menu to update it, or use the delivery key field in the form if one exists.
When you have changed or removed the existing delivery key, resume entering the delivery key for the content item or slot with which you were working.
Updating a delivery keyLink copied!
Once a delivery key has been updated, the related content item or slot must be republished before the updated key can be used to retrieve its content.
When the key of a published item is changed or removed without first being unpublished, the old key still exists and can be used to retrieve the version of the content with which it was published. This means any references in your systems to the old key may retrieve old content. To avoid retrieving old content you should ensure that the old key is updated or removed from your systems.
Removing and reusing delivery keysLink copied!
You may want to remove a delivery key, or remove it from content and then reuse it with other content. For example, you may want to replace a "Spring sale banner" on your home page with a "Summer sale banner", by switching the "home-page-sale-banner" delivery key from the Spring banner to the Summer banner.
Ensure that a delivery key no longer retrieves published content, by always unpublishing the content before deleting its delivery key.
To remove a delivery key from published content:
- Unpublish the content item you no longer want to retrieve with the delivery key. See how to unpublish content.
- Delete the delivery key from the content item.
- Optionally, republish the content if you still want to retrieve it via its ID URL.
Once you've removed a delivery key you can add that key to other content and publish it to create a new delivery key URL to retrieve the content.
Organizing content typesLink copied!
For a project with lots of content types, finding the one you want can be a challenge, but there are several features to help you keep your content types organized. You can sort the content type list, manage a list of favorites and search for a content type by name.
The sort options are available from the menu in the top right of the content type browser. You can choose to sort the list by the date that the content type was added to the repository, in ascending or descending order by name, by most commonly used content type, or with your favorites shown first.
To add a content type to your favorites, hover over the content type icon and click the star icon in the top right. Content types are removed from your favorites by deselecting the star.
When you choose a sort order it will apply to all the repositories on your hub. In the case of favorites, only those content types that have been added to the current repository will be shown in the list. The sort order is saved in your browser's local storage and will persist between logins.
Click in the search box and start typing to search for a content type by name. Only those content types containing the text you entered will be displayed in the list.
In the example below, only those content types with "localized banner" in their name are shown.
Viewing and editing contentLink copied!
To open content for viewing and editing, double-click on it in the content library. Alternatively, hover over the item you want to open until the ellipsis is shown, then select "View" from the menu.
You can search for content by label, content id and delivery key. See Searching for content.
Content item propertiesLink copied!
You can show or hide information about content by clicking the "i" icon at the top right of the authoring form. Content properties such as the content type, content Id and publish status are shown on the "Details" tab.
From this window you can also view content delivery URLs and view where content is used in other content.
Content Delivery URLsLink copied!
From the "Content delivery" properties tab you can view and copy the URLs and delivery keys that developers use to retrieve content. Clicking the URLs will fetch the content and display the result in a new window.
Note that content delivery URLs will only work when the content has been published, and will return the latest published version of the content.
If a delivery key exists for the content item or slot, it is displayed at the top of the "Content delivery" tab.
Content Delivery v2
If you have our next generation Content Delivery v2 API enabled on your hub, a Content Delivery v2 section is displayed.
This section will include the URL to retrieve the content using the Content Delivery v2 API with the content Id.
The following URLs may also be included:
If the content has a delivery key, a URL is shown to retrieve the content using the Content Delivery v2 API with the delivery key
If your environment is configured to use virtual staging, a VSE URL will be displayed for use with the content Id, and the delivery key if one exists
Content Delivery v1
In the Content delivery v1 section you can view and copy the Content ID URL for retrieving the content via the Content Delivery v1 API.
You can also access the VSE URL, which allows you to retrieve the latest version of your content to be visualized if your environment is configured to use virtual staging.
Variant delivery keys
If you have defined multiple delivery keys in your content, these are listed in the "Variant delivery keys" section. See Multiple delivery keys.
Finding parent contentLink copied!
From the "Used in" properties tab, you can find where content is linked to by parent content. You can expand listed content to get more details, and open the parent content by double clicking on it.
In the example below, a carousel slide is shown in the authoring form, and the "Used in" tab lists all the different carousels that include this specific carousel slide.
Developers can find linked parent content by using the Content Management API.
Editing a content itemLink copied!
Here's an example of editing a simple banner content item.
To use a different background image for the content, hover over the image until the "Replace" icon appears. Click the icon to choose a different image.
When Image Studio is enabled on your account, you can easily edit images as part of your workflow.
In this example, we'll also edit the subheading to "Grab some bargains!". Once the change is made we click the Save button. Notice that the visualization has updated to reflect the changes.
Editing linked contentLink copied!
Linked content is also easy to edit, as we'll show with the example of the carousel.
To open the carousel for editing, choose "View" from the item's contextual menu or double-click the item to open it.
The content opens showing the carousel and each of the carousel slides that it includes. To edit one of the carousel slides, hover over it, until the pencil and trash can icons are shown. Click the pencil icon to edit the carousel slide.
The carousel slide content item is now opened for editing.
After editing the item, clicking the Save button will return to the carousel. To go back to the carousel editing window without saving, just click the Back button.
Saving a content itemLink copied!
If you're working on content that hasn't been saved yet, the Save menu will contain a reduced set of options, like the example below.
To make your changes publicly visible, you must publish the content in addition to saving it.
Click the main Save button to display the "Save content" dialog. Give the content a name, choose which folder it should be saved in and optionally add a locale, status and assignee.
Once the content is saved, if there is a visualization defined for the content, then it will be displayed on the right hand side of the content form.
If you make a change to the content, then the Save menu will be enabled and contain a number of options, as shown in the image below. Even if the content is up to date and the Save menu itself is not enabled, you can still save another copy of the content or rename it.
Here's a summary of the options on the Save menu:
Save as - Creates a new version of the content, including the same values for the fields (in this case headline and strapline) and the same assets.
Save and create another - Saves and closes the content, and opens a new empty form for this content type. In the case of linked content, for example a carousel, that is the "parent" to "child" carousel slides, Save and create another is only available for the child content. This item is only enabled if the content has changed since last saved and the Save button is enabled.
Save and close - Saves the content and returns to the content library. This item is only enabled if the content has changed since it was last saved and the Save button is enabled.
Add to edition - Displays the "Add to edition" dialog for you to choose the edition to which you want to add the content item. See Adding content to an edition. If there are unsaved changes when you choose this option, you are prompted to save the changes before the 'Add to edition' dialog is displayed. See adding content to an edition for more details.
Tag snapshot to edition - Opens a dialog for you to choose an edition to which you want to add this specific version of the content. See Tagging a snapshot to an edition.
Save and update editions - Saves the content. If this content is used in any editions you can choose which editions to update with the latest version of the content. If the content does not require saving and the Save button is not enabled, then this will just be Update editions.
Delivery key - Displays the "Delivery key" dialog for you to add a delivery key that can be used instead of the content id to uniquely identify content items and slots within hubs. See delivery keys. Note, this option is dimmed if the form has been changed. Save any outstanding changes to make this option available.
Save and publish - Saves and publishes the content. If the content does not require saving and the Save button is not enabled, then the menu name will be Publish.
Rename - Displays the "Rename" dialog for you to enter a new name for the content.
Assign locale - Saves the content and create new variants of the content item for each locale you select. See content item localization for more details.
Archive - Saves the content and archives it.
Copying contentLink copied!
You can make new content by copying up to 20 content items or slots at a time. Choose whether to copy individual items or use the multiple item copy, that provides options for advanced copying.
When you copy items, links to any child items are copied, but not the child items themselves. So, if you copy a carousel and then change one of its slides, both the original carousel and the copied carousel will show the same updated slide.
Any assignees, statuses, locales and delivery keys associated with items are not copied.
Copying items that have delivery keysLink copied!
Delivery keys must be unique within a hub, therefore if you copy an item that has a delivery key, the key isn't copied. If the newly created item requires a delivery key you must add one.
If a delivery key is a required field for a content item or slot, the item cannot be copied and a notification informs you that validation has failed.
Copying an individual itemLink copied!
To copy an individual content item, choose "Copy" from the item's menu in the content library. In this example, the "Living Room- Fall Promotion" carousel item will be copied. Note, when you copy single content items in this way, the new copies are always placed in the top level "Content" repository. To copy to a different folder use the Copying multiple items method.
Give the new content a name and click OK.
The new content item is shown in the content library.
When an item has been copied, all of the fields will be copied from the original item. You can edit the new item to change whatever fields you choose, including the image in this example.
For the carousel used in this example, links to child items were copied, but not the child items themselves. If a slide is updated, both the original and the copy carousel will show the same updated slide.
Copying multiple itemsLink copied!
To copy multiple items, select the items in the content library and choose "Copy" from either the toolbar (1), or the right-click menu (2). Tip: to quickly select all displayed items, click "Select all". See Performing bulk actions.
Using default names for copiesLink copied!
To help streamline copying multiple items, the "Make copies" dialog defaults to "Quick Copy", which will add the prefix "COPY_" to copy names. The copies will be created in the same folder as the selected items, unless you choose a different folder.
If the "COPY_" prefix makes an item name longer than 150 characters, the name is truncated.
Renaming copiesLink copied!
As an alternative to accepting the default prefixed names, you can optionally specify the names that will be given to the copies.
If you don't specify names for the copies when the "Rename and copy" option selected, copies will be created with the same names as the original items.
You can edit individual names and also "find and replace" common patterns to change the names of new copies. To help you find terms easily, the term you enter to "match" isn't case sensitive. To give greater control over the names for the copies the term you enter to replace is case-sensitive.
In this example, "Winter" will be replaced with "Autumn" in the names of the copies, and the names of items are manually edited to include "banner".
You can continue to update item names by both "finding and replacing", and individually editing, until you are ready to copy the items.
Choosing a folder for the copiesLink copied!
If you want copies to be created in a different folder from the originals, choose or add a new subfolder. This example shows the "Autumn promotion" subfolder being added.
