> For the complete documentation index, see [llms.txt](https://docs.mapsindoors.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mapsindoors.com/cms/interface/media-library.md).

# Media Library

The Media Library is where you upload and manage all the visual assets used across your solution — icons, 2D models, and 3D models.

***

<figure><img src="https://393726209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7ggkwTwz3UJfNWm5Mwk%2Fuploads%2FTJIm4I4ClUIknGos3OC3%2Fimage.png?alt=media&amp;token=67b9ca8b-99e7-499d-89f1-205c7615f6cb" alt=""><figcaption></figcaption></figure>

***

### Opening the Media Library

You can open the Media Library from several places in the CMS:

* The **Media Library** button in the top navigation bar
* Any **Icon**, **2D Model**, or **3D Model** field inside a Display Rule editor
* Under Solution Details → App Settings → App Configuration → **App Categories.**

***

### Browsing and searching

All uploaded files are shown as a grid of previews. Hover over any file to see its filename, dimensions, and upload date.

Use the controls at the top to find what you need:

* **Sort** — order by filename (A–Z or Z–A) or upload date (newest or oldest first)
* **Type filter** — show only `.svg`, `.png`, `.jpg`, or `.glb` files
* **Source filter** — switch between your own uploads and the default MapsIndoors icon set. Default icons can be used freely but cannot be deleted
* **Search** — find files by name. Partial matches work — searching `off` will return `office.svg`, `offsite.png`, and so on

***

### Selecting a file

Click a file to select it — it highlights to confirm your choice. Click it again to deselect, or click a different file to switch. When you're ready, click **Select** to apply it.

***

### Uploading files

Click **Upload** to open your file browser and choose a file to add. A few things to be aware of:

* The maximum file size is **8 MB**
* If a file with the same name already exists, you'll be asked whether to overwrite it. Overwriting replaces the file everywhere it's currently used in your solution
* Filename matching is not case-sensitive — `Logo.png` and `logo.png` are treated as the same file

***

### Syncing media to other solutions

If you manage more than one solution, you can share media between them without re-uploading. Find the file you want to share, click the **Sync** icon, and select which solutions to sync it to.

If the target solution already has a file with the same name, it will be overwritten. If not, the file is simply added.

***

### Supported asset types

For guidance on preparing and using each type of asset, see:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Icons</h4></td><td><a href="https://393726209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7ggkwTwz3UJfNWm5Mwk%2Fuploads%2FR3NwQrK1wWRLSZ4Tcrcz%2FIcons%20Banner.png?alt=media&amp;token=3e5b03af-78c9-4a42-809a-056317002a26">Icons Banner.png</a></td><td><a href="/cms/interface/media-library/icons.md">Icons</a></td></tr><tr><td><h4>2D Models</h4></td><td><a href="https://393726209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7ggkwTwz3UJfNWm5Mwk%2Fuploads%2Fp6Z97Orqo7UnGhcx1tsS%2F2D%20banners.png?alt=media&amp;token=71b083fc-85b2-4b70-8d5b-80f6c0cb7c3b">2D banners.png</a></td><td><a href="/cms/interface/media-library/2d-models.md">2D Models</a></td></tr><tr><td><h4>3D Models</h4></td><td><a href="https://393726209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7ggkwTwz3UJfNWm5Mwk%2Fuploads%2F0J9GIMz8QAdRo4hvAxab%2Fimage.png?alt=media&amp;token=45b753fa-85b6-4243-a9bc-61e57d8951e5">image.png</a></td><td><a href="/cms/interface/media-library/3d-models.md">3D Models</a></td></tr></tbody></table>
