---
title: Manage media files
---

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

> **Note:** **Media libraries will be removed**
>
> Support for media libraries ended on 24 July, 2026. The feature and its associated APIs will be removed in two steps:
>
> - **August 2026** Refresh – the feature was hidden in the admin UI for projects that have no media libraries.
> - **September 2026** Refresh – the feature and all associated APIs will be fully removed.
>
> See [Media library migration](https://docs.kentico.com/guides/architecture/media-libraries-migration-guidance.md) for instructions on how to migrate your media library files to [Content hub](https://docs.kentico.com/documentation/business-users/content-hub.md).

On this page, you can find instructions on how to manage [media library](https://docs.kentico.com/documentation/business-users/media-libraries.md) files:

## Upload files into the media library

The following scenario describes how to insert new files into media libraries. Media libraries are suited for storing any type of large files, not only of media character:

1. Open a media library:
   1. Open the **Media libraries** application.
   2. Select a media library.
2. Insert files into the media library:
   1. Select the **Browse** button.
   2. Select files you want to upload. You can also select multiple files at once.

The file is now available in the media library and can be used in a channel or made available via a direct link.

> **Tip:** **Tip**: You can also drag and drop the files directly from the file explorer to a media library.

![Upload file to a media library](https://docs.kentico.com/docsassets/documentation/manage-media-files/media_library_upload.png "Upload file to a media library")

## Update existing media library files

You can update an existing media file by uploading an updated version of the file.

1. Open a media library:
   1. Open the **Media libraries** application.
   2. Select a media library.
2. Select the file you want to replace and select the **Upload new version** button.

The new version of the file is now displayed in all locations where the media file is used.

![Upload new version of a file](https://docs.kentico.com/docsassets/documentation/manage-media-files/upload_new_version.png "Upload new version of a file")

## Move media files

You can move media files between folders within a media library. Moving a file does not change the file URL. Files cannot be moved between media libraries, you need to upload the file to each media library.

1. Open a media library:
   1. Open the **Media libraries** application.
   2. Select a media library.
2. Select the file you want to move and select the **Move file** button.

   ![Move a media file](https://docs.kentico.com/docsassets/documentation/manage-media-files/ML_move_file_btn.png "Move a media file")
3. Select the folder where you want to move the file and select **Move**.

   ![Move file dialog](https://docs.kentico.com/docsassets/documentation/manage-media-files/ML_move_file_dialog.png "Move file dialog")

## Delete files from a media library

You can delete files from media libraries directly in the **Media libraries** application:

1. Open a media library:
   1. Open the **Media libraries** application.
   2. Select a media library.
2. Select the file you want to delete and select the **Delete** () button.

The file is now removed from the media library and is no longer available publicly.

![Delete file from media library](https://docs.kentico.com/docsassets/documentation/manage-media-files/media_library_delete.png "Delete file from media library")

## Manage folders

You can create folders in media libraries to organize your files. Folders in a media library are also reflected in the file system. To create a folder in a media library:

1. Open a media library.
   1. Open the **Media libraries** application.
   2. Select a media library.
2. Navigate to a location in the media library where you want to create the new folder.
3. Select **Add new folder** and fill in the folder name.

   - The folder name can contain only alphanumeric characters, underscores ('_\__'), hyphens ('_-_'), and cannot contain file names [reserved by the operating system](https://learn.microsoft.com/en-us/windows/win32/fileio/naming-a-file) (e.g., '_CON_', '_PRN_', '_AUX_' for Windows).
4. **Save** the folder.

Media files can now be uploaded into the new folder. You can also rename the folder by selecting the **More actions** () button next to the folder you want to rename.

![Add folder in a media library](https://docs.kentico.com/docsassets/documentation/manage-media-files/ML_add_folder.png "Add folder in a media library")

## Edit media file properties and metadata

You can edit the properties and metadata of media files in the **Media libraries** application:

1. Open a media library.
   1. Open the **Media libraries** application.
   2. Select a media library.
2. Select the desired file to display a panel with file properties and metadata.
3. Edit the values and select **Save** once you are done.

![Media file metadata](https://docs.kentico.com/docsassets/documentation/manage-media-files/media-library-file-properties.png "Media file metadata")