---
title: Creating media libraries
---

> 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).

To create media libraries for the currently active site:

> **Info:** **Note**: If you are an administrator, you can configure the storage options and file restrictions for media libraries in general. See [Configuring media libraries](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-media-libraries.md).

1. Open the **Media libraries** application.
2. Click **New media library**.
3. Fill in the following details:
   - **Display name** – the name of the media library displayed in the administration interface and on the live site.
   - **Code name** – the name of the media library used by developers in code.
   - **Description** – the text describing the media library.
   - **Teaser image** – the image used as the media library teaser.
   - **Folder name** – the name of the folder where files will be stored.
   - **Use direct path for files in content** – if enabled, the system uses the direct file path in URLs when editors add files from this library to content in Xperience (instead of permanent media file URLs). For example, this applies when adding media files using the [rich text editor](https://docs.kentico.com/13/managing-website-content/editing-rich-text-content.md) or widget. Files accessed through a direct path are not handled by the system (no permission or security restrictions are enforced, no image resizing is applied).

     ![Creating a media library](https://docs.kentico.com/docsassets/13/creating-media-libraries/creating_media_library.png "Creating a media library")
4. **Save** the media library.

The system creates the media library and the associated folder on the file system. The **Media library**  interface appears.

- The **Files** tab allows you to manage the media library content.
- The **General**  tab is used to edit the properties that you entered when creating the media library.
- The **Security** tab allows you to adjust permissions to work with folders and files in the given media library. For more details on how to adjust permissions in media libraries, see [Assigning permissions to media libraries](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-media-libraries/assigning-permissions-to-media-libraries.md).