Content item assets are content items of certain content types that allow you to upload and store various types of files, for example photos, pictures, sound files, videos, package files, presentations, or documents. Content item assets stored in the Content hub can be reused throughout the system. Different variants of image assets can be displayed in different contexts to ensure optimal visual presentations.
To upload a file to the Content hub:
The asset is now created in the current workspace and needs to be published before it is publicly available.
To make uploading a large number of files easier, your administrators can configure mass asset upload for your project. You can then upload multiple files in bulk and automatically convert them to content item assets of a configured content type.
The assets are now created in the selected workspace and need to be published before they become publicly available.
If you need to access or modify a file previously uploaded to the Content hub, you can download it from a content item asset.
To download a file from a content item asset:
Open the Content hub application.
Select a content item asset.
Download () the asset.
The asset is now downloaded to your device.
To help ensure that the images you use across different channels are properly optimized, your administrators can enable automatic image optimization. However, you can also manually optimize any image asset in the Content hub by changing the format of the image or reducing its size by adjusting image quality.
Edit a content item asset that contains an image.
Adjust the image ().
Change the Image format or Quality of the image.
If you notice undesired compression artifacts (opens in a new tab) in the optimized image, try increasing the quality until the artifacts are no longer visible.
You can preview the outcome of your adjustments on the image in the Adjusted image info section.
Save the changes.
Xperience preserves all original images in the background, ensuring that optimizations are always applied to the original file rather than a previously modified version. This means that multiple adjustments do not compound quality loss. For example, if you change an image's quality from 70% to 50%, the compression is applied as if you were reducing quality directly from 100%, rather than from the already compressed 70%.
Image variants are cropped or resized versions of an image, defined by a specific aspect ratio and pixel dimensions configured by your project administrator. They allow control over how images appear in different contexts, such as hero banners, social media posts, or thumbnails. Image variants also help with art direction (opens in a new tab) or resolution switching (opens in a new tab), allowing you to display different versions of the image on various layouts.
Your developers or admins set up how images are displayed, so you don’t need to identify or track which variant is currently rendered on the site. If you need a page or widget to always show a specific variant instead of using the automatic selection, ask your developers to add a widget property that allows this. Once that's configured, you can select the variant directly in the widget properties, the same way you would configure other widget settings.
When you insert an image into rich text, you select the variant yourself.
Image variants are generated from the primary optimized image, taking into account its format and quality. Your developers can display image variants on the pages of website channels.
There are two types of image variants available:
When using Scaled variants, images can be scaled up if the specified dimensions exceed the original image dimensions. This may result in blurry images or increased file sizes due to image upscaling.
To see how your image will look in various variants:
Image variants are automatically cropped based on the image’s focal point. When an image is uploaded, the focal point is initially placed at its center. To adjust how all image variants are cropped, move the focal point to your preferred location.
You don't need to have any image variants defined in your project to adjust the focal point. Once administrators define new variants, they will be automatically cropped according to the selected focal point.
All image variants, except those cropped manually, are now re-cropped according to the updated focal point.
Automatic focal point selection with AIRA
AIRA can automatically select the best focal point for your image during file upload. See the AIRA documentation to learn more.
You can manually crop an image variant to fine-tune its design by repositioning or resizing the crop. The crop retains the aspect ratio and dimensions defined for the variant.
Manually cropped images, marked by the icon, are not affected by the focal point change on the primary image.
To use assets stored in Xperience across different platforms (such as social media), you can copy the URL of a published content item asset or an image variant. If you replace or modify the asset, you'll need to publish it again before you can copy the URL.
To copy a URL of a content item asset:
To copy a URL of an image variant:
The copied URL path includes the domain of the Xperience administration by default. If you need to use a different domain, such as the domain of a website channel, manually change the corresponding part of the URL.
For example, if the copied URL is https://admin.example.com/getContentAsset/... and your website channel uses https://www.example.com, you should replace the domain accordingly to https://www.example.com/getContentAsset/....