Asset Library
The Asset Library is the central place inside a project where you upload, organise and reuse all of your media files—images, videos, audio, documents and more. Assets stored here can be referenced from any Media field inside your collections and are also exposed through the Content API.
Key Capabilities
| Feature | What it does |
|---|---|
| Upload | Drag-and-drop or browse to add new files. Automatic file-naming, thumbnail generation (for images) and metadata extraction. |
| Search & Filter | Real-time search by name / type plus quick filters for Image / Video / Audio / Document and date ranges (Today • Week • Month • Quarter). |
| Sorting | Sort by Newest / Oldest / Name / Size. |
| Bulk Select & Delete | Tick multiple assets and delete them in one go (soft-delete with Trash support, or permanent via API). |
| Details Modal | Click any item to preview the file, read its metadata, copy URLs, edit Alt-text / Title etc. |
File size is limited by the smaller of
MAX_FILE_SIZE(env) and PHP’supload_max_filesize. The UI displays the exact limit. See Configuration for more details.
UI Layout at a Glance
| Area | Description |
|---|---|
| Toolbar | Upload button, Delete / Bulk Delete actions. |
| Filters bar | Search box, Type dropdown, Date filter, Sort menu, Per page selector. |
| Grid | Responsive card grid with thumbnails / icons and inline size & extension badges. |
| Table | Table view with thumbnails / icons and inline size & extension badges. |
| Checkboxes | Top-left corner of each card for multi-select. |
| Action menu | Three-dot menu (⋯) per asset ⇒ Edit, View Details, Download, Delete. |
Best Practices
- Use meaningful Alt-texts for images to improve accessibility.
- Store SVGs when possible for logos / icons; they resize perfectly.
- Optimise large media before upload to save storage and bandwidth.
- Clean up unused assets periodically with bulk select → delete.