Audience: User
The media library stores images and other assets used across your project (and optionally global assets). Authors upload once, then pick assets from page properties, record forms, and related pickers.
| Role | Purpose |
|---|---|
| Content author | Upload and pick images |
| Project lead | Keep brand assets organized |
Media → Library — browse and manage
Media → Add Media — drag-and-drop multi-file upload
Library scope toggle: Project | Global
Filters include type (Image, Audio, Video, Document, Spreadsheet, Archive) and category / subcategory when used.
Project scope supports bulk select + delete and upload.
📷 Media library
Image Path:
images/media-library.png
Alt Text:
Media library grid showing uploaded images with project/global scope
Caption:
Project media library.
Expected result: New files are available in media pickers.
Tip: Prefer web-friendly formats sized for mobile screens.
📷 Media picker in the builder
Image Path:
images/media-picker.png
Alt Text:
Media picker dialog with searchable assets inside the page builder
Caption:
Choosing an image from the library while editing a page.
| Action | User | Admin |
|---|---|---|
| Browse / upload project media | Yes | Yes |
| Use global media | Yes | Yes |
| Problem | Cause | Solution |
|---|---|---|
| Upload fails | Size / type / network / body limit | Retry; ask admin if server max body is too small |
| Cannot find asset | Wrong project or scope | Switch project; check Project vs Global |
| Image blank on page | Wrong asset | Re-pick; republish the page |