Assets in content items
Media files, such as pictures, videos, or documents, are essential to your content items. In Kontent.ai, these media files are called assets.You can do a lot with assets. It all depends on your content model and the options available to you as a content creator.
Explore your path to mastery
- Add structure to your content and see how assets work within the structure.
- Improve SEO and performance by optimizing your assets for the web.
- Your asset requirements might influence the way you set up your projects.
Add assets to your content items
There are several ways to add assets. Which to choose? That depends on two criteria: your intent and how your content is structured.Kontent.ai automatically puts new assets in your project’s asset library. You can reuse assets in the asset library any number of times you want.
Add assets in predefined fields
If your content item comes with asset elements, adding new assets is straightforward. Drag your file onto your asset element. Or click browse to select a file from your hard drive. You can also select an existing asset from your asset library. With asset elements, you can upload anything from pictures to videos or documents, such as PDFs. Your asset element might have guidelines that tell you what kind of assets you should use.Add assets to the text
If you need to add an image without specifying information about the image’s width, alignment, or caption, insert the image directly in your text. In your rich text, click and then . The image will be inserted at the position of the cursor.Add assets with single-use contextual information in the text
If you need to specify how the image should look in context with the text around it, you’ll want to insert the image through a component. For example, this lets you specify image metadata like width, alignment, caption, and more.This approach requires having a dedicated content type for assets.
- In a rich text element, click and then .
- From the list of types, select Image.
- Your content type for assets might have a different name.
- Fill in the elements.
From single-use to re-useIf you later find another use for the content in your component, you can always convert it to a content item by clicking .
This conversion cannot be undone. If done by accident, archive the new item and create your component again.
Customize assets for a better fit
You can customize images used in content items within a few clicks. This is especially useful when you add an asset to an asset element, and it doesn’t meet the element’s limitations specified in your content model.Replace assets
Replacing assets is similar to adding new ones. After you upload a new asset, remove the outdated one by clicking in the top-right corner.We recommend deleting the old asset afterward to avoid cluttering your project’s asset library.
- In Content & assets, enter the name of the image item in the filter at the top.
- Open the content item.
- (If your item is published) Click Create a new version at the top.
- Remove the current image and add a new one.
- (Optional) Click Publish… at the top of the page.
You can also try out the early access feature to directly replace your asset in the asset library without manually updating your content items.