---
title: Work with asset files in Content hub
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

## Work with assets in Content hub

Storing files in _Content hub_ means you can reuse them in different digital marketing activities across your marketing [channels](https://docs.kentico.com/guides/digital-marketing/work-with-channels/digital-marketing-channels.md). Assets in the _Content hub_ provide you with helpful features that make managing large projects a breeze.

You can preview all content items with images (in Kbank based on the _Asset_ content type) and switch between view modes to suit your current [workflow](https://docs.kentico.com/guides/digital-marketing/work-with-workflows/workflows.md).

![Asset content type](https://docs.kentico.com/docsassets/modules/work-with-asset-files-in-content-hub/cm-guide-content-hub-assets-preview.png "Asset content type")

If you need to add multiple files to the _Content hub_ at once, use the **Upload files** button.

![Upload files in bulk](https://docs.kentico.com/docsassets/modules/work-with-asset-files-in-content-hub/cm-guide-mass-file-upload.png "Upload files in bulk")

You can also upload an image **directly from a widget** while editing a page.

![Create new item in widget](https://docs.kentico.com/docsassets/modules/work-with-asset-files-in-content-hub/empty-image-widget.png "Create new item in widget")

### Upload assets using smart drag and drop asset upload

Besides using the _Upload files_ button, Xperience also supports **smart drag and drop asset upload**, which speeds up uploading assets.

You can drag a file from your computer and drop it into supported areas of the interface. Once the file is dropped into an upload zone, Xperience uploads it and creates a new content item asset in the _Content hub_.

![Smart upload zone](https://docs.kentico.com/docsassets/modules/work-with-asset-files-in-content-hub/smart-upload-drag-and-drop-zone.png "Smart upload zone")

> **Info:** What makes the upload smart? When you drag and drop a file into Xperience, AIRA works for you in the background: it optimizes the file for fast loading, creates responsive variants for different devices and views, creates a clear image alt text for accessibility, and adds tags to categorize the image so the asset is easy to find and reuse.

Smart upload can be used in several places across Xperience. For example:

- Directly in the _Content hub_.
- In **Page Builder widgets**, such as the _Image widget_, or the _Rich text widget_.
- While creating content items such as **articles**.
- In the **Content view** of a page.

This means you can upload images directly where you are working, without first switching to the Content hub. The uploaded files are still stored as reusable assets in the Content hub.

### Work with image variants and taxonomy tags

When you upload an image (whether through the _Content hub_ or a widget), Xperience can automatically create [image variants](https://docs.kentico.com/documentation/business-users/content-hub/content-item-assets.md#image-variants) for different devices and applies [taxonomy tags](https://docs.kentico.com/guides/digital-marketing/work-with-taxonomies/taxonomies.md#what-are-taxonomy-trees-tags-or-parent-child-relationships) to help categorize the images.

Your developers configure the _image variants_ and set up your website so the correct variant automatically appears on each page or in a widget, based on things like the user's device and placement on the page. That's on the technical side, not something you need to set up or track. But if a specific widget always needs to display a particular variant, ask your developer to add a [widget property](https://docs.kentico.com/documentation/developers-and-admins/development/builders/page-builder/widgets-for-page-builder/widget-properties.md) that lets you select that variant.

> **Info:** Automatic image tagging works only for mass image uploads. If you upload a single image into a content item, the auto-tagging process may not be triggered, so you'll have to assign the tags manually.
>
> For more details on tags and taxonomy, check out our material on [working with taxonomies](https://docs.kentico.com/guides/digital-marketing/work-with-taxonomies/work-with-taxonomies-in-kbank.md).

The automatic taxonomy tags are generated using [Azure AI services](https://learn.microsoft.com/en-us/azure/ai-services/what-are-ai-services), which means results can vary. The same image may receive slightly different tags at different times, as the process is not standardized. You can, however, review and edit these tags as needed.

![Updating automatic taxonomy tags](https://docs.kentico.com/docsassets/modules/work-with-asset-files-in-content-hub/update_automatic-taxonomy-tags.png "Updating automatic taxonomy tags")

To ensure no unapproved data is published live, you can apply different [content management workflows](https://docs.kentico.com/documentation/developers-and-admins/configuration/workflows.md). You can also fully control who on your team uses the assets and how they use them through [workspaces](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management/workspaces.md).

You can also create asset variants for different languages to ensure that your visitors receive properly [localized content](https://docs.kentico.com/documentation/developers-and-admins/configuration/languages.md), and use [taxonomies](https://docs.kentico.com/documentation/developers-and-admins/configuration/taxonomies.md) to categorize your images accordingly.

> **Info:** Note that assets in _Content hub_ don’t support versioning. If you replace a file, only the latest version is available. To learn more, see the [Content versioning](https://docs.kentico.com/documentation/business-users/content-versioning.md#assets) page.

Xperience also provides an out-of-the-box method to **restrict access** to a file, meaning only logged-in visitors can view or access it.

![Content items that require the user to sign before viewing their content](https://docs.kentico.com/docsassets/modules/work-with-asset-files-in-content-hub/cm-guide-secured-access.png "Content items that require the user to sign before viewing their content")