Work with media in content items
Media files such as pictures, videos, or documents, are an essential part of your content items. In Kontent, these media files are called assets.
You can do a lot with assets. It all depends on your content model and options available to you as an content creator. Let's get cooking!
Table of contents
Add assets to your content items
There are several ways to add assets. Which should you choose? That mainly depends on two criteria: your intent and how your content is structured.
Kontent automatically puts new assets in your project’s asset library.
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 reuse existing assets.
With asset elements, you can upload anything from pictures to videos, or even documents, such as PDFs. Your asset element might have guidelines that tell you what kind of assets you should use.
Add assets in text
If you need to add an image without specifying information about the image's width, alignment, or caption, go ahead and insert the image directly in your text.
In your rich text, click Insert... and then Insert image. The image will be inserted at the position of the cursor.
Add assets with single-use contextual information in 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 the rich text element, click Insert... and then Insert new component.
- From the list of types, select Image.
- Your content type for assets might have a different name.
- Fill in the elements.
Customize assets for a better fit
With advanced asset management, you can customize images used in content items within a few clicks. This is especially useful when you add an asset to the asset element and it doesn't meet the size limitations specified in your content model.
Images fit for customization must meet the following requirements:
- Image format needs to be jpeg, png, gif, or webp.
- Image dimensions must be smaller than 8193 x 8193 px.
- Image size can't exceed 50 MB.
To customize an image:
- Navigate to the asset element that holds the image.
- Click Customize in the image's top-right corner.
- Customize the image dimensions to fit your needs.
- If there are any limitations set for the element, customized dimensions are prefilled to fulfill them.
- Scale the image as needed by moving the slider.
- You can't scale the image beyond its original size.
- On the left, move the image selection to get the desired part of the image.
- (Optional) Click Preview to see what your customized image looks like.
- Click Save.
Your customized image is now used in the asset element of the specific content item. The original image is not affected by this change.
Remove customized image
To remove a customized image, click Customize and then Delete customized image in the lower-left corner. The customized image will be deleted and replaced by the original image.
Replacing assets is similar to adding new ones. After you upload a new asset, remove the outdated one by clicking Remove in the top right corner.
We recommend deleting the old asset afterward to avoid cluttering your project's asset library.
If you converted your image component to a content item, you can replace the asset across your entire project. You only need to replace it in one content item and it will be updated everywhere.
To replace one image with another:
- In Content & assets, enter the name of the image item in the filter at the top.
- Open the filtered out 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.
Now your asset will be automatically replaced wherever it is used (you can see where under Used in in the right sidebar).
Tagging your assets is like brushing your teeth. You may find it a chore at first, but everyone will be grateful if you keep at it in your day to day. Tagging helps you keep your library organized and the asset easy to find.
Put a shiny smile on your assets with asset taxonomies.
- In your content item, click on one of the added assets.
- Fill in the asset taxonomies that you see under localized descriptions.
If you need to tag multiple assets, use your asset library. In Content & assets > Assets, select a few assets, and click Assign taxonomy terms.
Find your assets
Find the assets you need using the search bar. The search looks into the titles and descriptions of your assets.
With advanced asset management you also get to filter assets by your asset taxonomies. For example, you can quickly find assets based on what they contain, which department they belong to, or where they're used on your site. The exact options will depend on how your taxonomies are set up and whether all assets are tagged.
Nobody likes duplicate content, much less duplicate assets.
To re-use some of the existing assets from your project in your new content item:
- In your asset element or content type for assets, click Pick from Assets.
- Use search and filters to find the assets you want.
- Choose the assets you want to use.
- Click Insert.
To change the order of an asset in an asset element, drag the asset by grabbing the Drag button in its top-left corner.
You can remove an asset from the content item by clicking Remove in the asset's top right corner.
When you remove an asset from your content item, the asset itself is still kept in your project's asset library. Make sure you delete the asset if you don't need it anymore. Less clutter helps in the long run.