> 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.
***
***
### 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:
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.mapsindoors.com/cms/interface/media-library.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
