---
title: Configuring supported file types in Media libraries
related:
  - https://docs.kentico.com/k12sp/configuring-kentico/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).

Media libraries support the following types of images: **bmp**, **gif**, **png**, **jpg**, **jpeg**, **tiff**, **tif**. These types of image files can be 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).

> **Info:** 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.

## Allowing custom file types to be added into media libraries

You can allow custom file types by modifying the site's **web.config** file (or properties of the **MediaControl.ascx** control). The system can recognize and process any media types, if you have the right player for the given file type. By specifying the file types in the web.config keys, the automatic detection and support of media files is disabled and only the specified file types are recognized as image/audio/video files by the system.

### Example of configuring custom detection of media file types

To allow only media files of selected types to be added into media libraries:

1. Add the following keys into the **appSettings** section of your **web.config** file.

   ```html

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

   ```
2. Save the **web.config** file.

> **Note:** **Vector graphic formats unsupported**
>
> Vector graphic formats (such as **svg**, **eps**, **pdf**, **ai**) are not supported as image extensions in media libraries. These formats can be stored as documents, but cannot be diplayed as images.

#### Allowing upload of selected files into 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.