---
title: Configuring supported file types in Media libraries
related:
  - https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-media-libraries.md
---

> 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:** **Extended image support in Refresh 10**
>
> Support for **WebP** and **SVG** images is available only after applying [hotfix 13.0.115](https://devnet.kentico.com/download/hotfixes) (Kentico Xperience Refresh 10) or newer to your projects.

Media libraries support the following types of images: **bmp**, **gif**, **ico**, **png**, **wmf**, **jpg**, **jpeg**, **tiff**, **tif**, **webp**. These types of image files can be uploaded and displayed on your site by default.

The system detects audio and video files based on their [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) (audio types starting with the _audio/_ prefix and video types starting with the _video/_ prefix). For successfully detected audio and video file types, the system renders appropriate HTML5 markup. The types of files that can be previewed or played on your site therefore depend on the web browser (modern HTML5 web browsers typically support one or more of the **ogg**, **mp4**, or **webm** video codecs, and **mp3**, **wav**, or **ogg** audio codecs).

All other file types are recognized as **documents**, which means that you cannot play them as videos or display them as images. You can still store them in the library and users can download them on the live site.

## Enabling upload of other file types

If you want to configure the system to allow upload of a custom file type into media libraries, you need to:

1. [Enable the custom file extensions](#allowing-upload-of-selected-files-into-media-libraries) to be uploaded into media libraries.
2. (_Optional_) If you want to use the custom extension as an image, audio, or video file, you need to configure the system to [recognize the extension as a media file](#configuring-custom-detection-of-media-file-types).

### Allowing upload of selected files into media libraries

To customize what media files and documents can be uploaded to media libraries:

1. Open the **Settings** application.
2. Navigate to the **Content → Media** category.
3. Add the selected file extensions into the **Media file allowed extensions** setting (separated by semicolons).
4. **Save** the changes.

### Configuring custom detection of media file types

By default, the system can recognize and process any media type, if you have the right player for the given file type. You can allow custom file types to be recognized as media files via configuration keys. However, by adding the media file type configuration, you disable automatic detection and support for media file types other than those explicitly specified.

To configure specific file types to be recognized as media:

1. Add the following keys into the **appSettings** section of your **administration** project's **web.config** file.

   ```html

   <add key="CMSImageExtensions" value="bmp;gif;ico;png;wmf;jpg;jpeg;tiff;tif;webp" /> 
   <add key="CMSAudioExtensions" value="wav;mp3" /> 
   <add key="CMSVideoExtensions" value="mp4;ogg" />

   ```
2. Save the **web.config** file.
3. Add the same keys with the same values to the configuration file of your **live site project**, depending on your [development model](https://docs.kentico.com/13/developing-websites/xperience-development-models.md):
   - **web.config** for MVC 5 projects
   - **appsettings.json** for ASP.NET Core projects (by default)

     ```js title="apsettings.json example"

     "CMSImageExtensions" : "bmp;gif;ico;png;wmf;jpg;jpeg;tiff;tif;webp",
     "CMSAudioExtensions" : "wav;mp3",
     "CMSVideoExtensions" : "mp4;ogg"

     ```

Files of the specified types are now recognized as media files of the corresponding type. For example, image files are offered in the _Insert image_ dialog of the [rich text editor](https://docs.kentico.com/13/managing-website-content/editing-rich-text-content.md).

> **Note:** **Limited support for specific graphic formats**
>
> The [WebP](https://developers.google.com/speed/webp) image format is supported by default in media libraries (and by [page attachments](https://docs.kentico.com/13/managing-website-content/working-with-files/page-attachments.md)). The [SVG](https://en.wikipedia.org/wiki/SVG) vector format for images is also supported. However, SVG images may host scripts or CSS and pose a security risk. If you wish to use the SVG image format, you need to manually [enable support](#enabling-upload-of-other-file-types) for the extension.
>
> Certain image features do not work for WebP and SVG files – the built-in [image editor](https://docs.kentico.com/13/managing-website-content/working-with-files/editing-images.md), automatic generating of image thumbnails, image resizing API (such as the _WithSizeConstraint_ extension method when [displaying images](https://docs.kentico.com/13/developing-websites/retrieving-content/displaying-content-from-media-libraries.md)).
>
> Other vector graphic formats (such as **eps**, **pdf**, **ai**) are not supported as image extensions in media libraries. These formats can be stored as documents and displayed on the live site, but the thumbnail preview and image editor is unavailable for such files.

### MIME type mapping for WebP files

If you wish to use WebP images, make sure that you have a [](https://learn.microsoft.com/en-us/iis/configuration/system.webserver/staticcontent/mimemap) MIME type mapping under the __ element in the _web.config_ file of your administration project, as well as the live site project if using the [MVC 5](https://docs.kentico.com/13/developing-websites/mvc-development-overview.md) development model.

```xml

...
<staticContent>
  <remove fileExtension=".webp" />
  <mimeMap fileExtension=".webp" mimeType="image/webp" />

```