• Cheat sheets
  • Documentation
  • API reference
  • Product updates
  • Sign in
Kontent.ai Learn
  • Try Kontent.ai
  • Plan
  • Set up
  • Model
  • Develop
  • Create
Copyright © 2024 Kontent.ai. All rights reserved.
  • Web
  • Privacy policy
  • Cookies policy
  • Consent settings
  • Security
  • GDPR
  • Docs
    • AI-accelerated image operations
    • Asset library
    • Asset taxonomies
    • Assets in content items
    • Custom asset domains
    • Customize images
    • Model assets
  • Collections
  • Custom apps
  • Custom elements
  • Environments
  • Keyboard shortcuts
  • Mission Control
  • Projects
  • Task management
  • Terminology

Asset library

Jan Cerman, Martina Farkasova
13 minutes
Assets
Download PDF
Your asset library gives you a complete overview of the files uploaded to your project.

Assets overview

Whenever you add an asset to your content item, this new file is stored in the project’s asset library. You can find your asset library in Content & assets > Assets.
In Assets, you can:
  • Upload an asset via drag & drop or select a file on your machine.
  • Place assets in folders.
  • Search and filter assets.
  • Manage asset details.
    • Change the asset title, description, and codename.
    • Tag assets by adding taxonomy terms.
  • Download assets.
  • Delete assets.

Use asset folders

Folders are a handy way of keeping your assets organized. For example, you can group assets in folders and subfolders depending on your needs, such as brand, product area, or asset usage.
  • To create folders and subfolders, click Create new folder. Folders are sorted alphabetically.
  • To rename existing folders, click .
  • To re-organize assets within your folders, select a few assets and click Move assets.
  • To move folders and their contents, open the folder you’d like to move and click Move folder.

Search for assets

Find the assets by typing into the search bar. The search looks into asset titles, file names (including file extensions), and descriptions. With AI, you can also search by the image contents. If you use asset taxonomies to organize your asset library, you can search by the assigned taxonomy terms. Use the taxonomy filter on the left to narrow the results down.
You can sort assets by name, creation date, or file size. In the asset library, Kontent.ai remembers your selected sorting option.

Manage asset details

You can view asset details by opening the asset in the asset library or from the content item that uses the asset. In the asset details, you can:
  • Add an asset title
  • Add localized asset descriptions to use as the alt text for your image.
    • You can edit asset descriptions for a single language or all languages.
    • With AI, you can generate localized asset descriptions based on image contents.
  • Tag your assets with specific taxonomy terms to categorize them.
In the right panel, you’ll find the asset metadata.
  • File name
  • File size
  • Image width
  • Image height
  • What’s in the image? – AI-generated labels to help with searching for assets by content
  • Created – who uploaded the image and when
  • Last updated – who last made changes and when
  • Collection – the collection the asset belongs to
  • Used in – a list of content items (and their variants) where the asset is used

Fast asset replacement

Replace assets with their new versions on the fly using fast asset replacement. Fast asset replacement is currently available in Innovation Lab.
To replace your existing assets:
  1. In  Content & assets, go to Assets.
  2. Open an asset you want to replace.
  3. Click > Replace file.
  4. Select the checkbox to confirm you understand the consequences.
  5. Click Replace.
  6. Select the file from your local device to replace the asset.
  7. Proceed to replace the asset.

Get asset URL

The URL you copy from the asset details may change when you update the asset. If you want to use the asset in your app, we recommend that you insert the asset into a content item and then retrieve the item with the asset. This way, you can be sure you always get the correct asset even after it is updated. When you want to share an asset with your coworkers or link it in an email, get the asset URL:
  1. In  Content & assets > Assets, click an asset to open it.
  2. Click .
  3. Click Copy asset URL.
  4. Click .

Delete assets

You can only delete an asset when it’s not used in any of your content items. This also means you can’t delete an asset directly when editing a content item because the asset is used in that item. To delete an asset:
  1. In Content & assets > Assets, click an asset to open it.
  2. Click .
  3. Click Delete.

Restore assets

See how to restore previous versions of content items.
On the left, use Refine results to filter your assets by collections and taxonomies.On the right, choose how the assets are sorted. By default, the newest ones are first.
The right panel is where you find all the asset metadata.
Keep in mind that the replacement is immediate.
Keep in mind that the URL might change if someone replaces the asset.
Keep calm, you can only delete unused assets.
When you restore an older version of a content item that uses a previously deleted asset, you restore the asset as well. The restored asset will appear in Content & assets > Assets.
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.
To find uncategorized assets faster, choose the Not in… option in the taxonomy filter. You’ll get the assets not tagged with any of the terms in that specific taxonomy.
Fast asset replacement considerationsBefore activation, get familiar with how fast asset replacement works and if it may affect your project:
  • Replacing an asset affects all content items using it, including published content.
  • The asset URL changes after replacement. This affects any uses of or links to the asset.
  • The replaced asset is removed from the UI but not from storage and remains available at its original asset URL.
  • The replacement ignores content type limitations for the file type, file size, and image resolution.
  • The replacement keeps existing asset renditions. This can result in incorrectly customized images. You may need to check them manually afterward.
  • The replacement is immediate and cannot be undone.
Deleting multiple assets is fail-safeSelect multiple assets at once using Shift + click. After you click Delete assets, only the assets that aren’t currently in use will be deleted.
  • Assets overview
  • Use asset folders
  • Search for assets
  • Manage asset details
  • Fast asset replacement
  • Get asset URL
  • Delete assets
  • Restore assets