> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/user-guide/media-center/media-center-widget.md).
# Media Center Widget
### Overview
The Media Center widget is a powerful tool for showcasing visual content across your platform. Whether you want to manually curate a gallery or automatically sync images from a specific project folder, this widget provides a seamless, dynamic experience for both creators and viewers.
***
### Media Selection Modes
When setting up a Media Center widget, you can choose between two distinct Media Types depending on how you want to manage your content.
#### Specific Folder (Dynamic Syncing)
This mode allows you to point the widget directly at a folder. The widget automatically fetches all images (JPG, PNG, JPEG, GIF) within that folder, ensuring your gallery stays up to date without manual editing.
* Folder Selection: Use the dropdown to select from public projects, groups, departments, or your current team context.
* Automatic Fetching: The widget displays up to 99 images, sorted by the most recently updated.
* Sub-folder Note: Only images in the root of the selected folder are displayed; contents of sub-folders are not included.
* Live Updates: Changes to the folder are reflected on the next refresh. Image lists are cached for 30 minutes to maintain site performance.
#### Media Center Link (Manual Selection)
If you prefer to hand-pick specific assets, use the Media Center Link option.
* How to use: Simply paste an `mlink-style` URL copied directly from the Media Center into the widget properties.
***
### Configuration Options
You can customize the look and behavior of your gallery through the widget properties dialog.
| **Feature** | **Description** |
| ------------- | ----------------------------------------------------------------------------------- |
| View Type | Toggle between a Slider (one image at a time) or Carousel (multiple thumbnails). |
| Auto Scroll | Enable this to have the gallery automatically advance through images. |
| Auto Rotate | Enable this to have the gallery loop back to the beginning once it reaches the end. |
| Display Count | For folder-based galleries, choose how many images to show (1–99). |
| Header Image | Add a custom header image to the top of your widget for branding. |
***
### Creator Experience
The Media Center widget features a Live Preview in the properties dialog. As you adjust settings like View Type or Auto Scroll, the preview dynamically updates to show exactly how the widget will appear on the page, including live thumbnails from your selected source.
#### Permissions & Access
The widget respects folder permissions to ensure data security:
* If a user has access to the source folder, they will see the images.
* If a folder is moved or its privacy settings are changed so it is no longer accessible, the widget will display a graceful error message: *"The folder is no longer accessible."*
***
### FAQs
**How often does the widget update?**
The widget checks for new folder content every 30 minutes. You can trigger an immediate refresh by manually refreshing the widget or the page.
**Can I display videos?**
The Media Center widget is currently optimized for image formats, including JPG, PNG, JPEG, and GIFs.
**What happens if I change the folder name?**
The widget maintains its connection to the folder ID; however, we recommend verifying the widget preview if major structural changes are made to your projects.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://guides.mangoapps.com/user-guide/media-center/media-center-widget.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.