Media
Images, documents, videos and audio are stored as media and reused across the site. Upload once, use anywhere; replace the file and every page using it updates.
See responsive media and a gallery on the demo site:
Media types
Image
Photos and graphics. Uploaded at full size; the site generates the sizes it needs.
Document
PDFs, Word and Excel files for download.
File
Any other file, including CSV data for charts and datatables.
Video
An uploaded video file. Prefer Remote video where possible.
Remote video
A YouTube or Vimeo URL.
Audio
An uploaded audio file.
Model
A 3D model.
Font and Icon
Used by Themers; see Theme settings.
List media
Manage → Content → Media (/admin/content/media) lists all media in a table. Filter by name, type or published status. Media is shared, so check here before uploading something that may already exist.
Add media
Manage → Content → Media → Add media (/media/add) lists the types; pick one to open its form.
For an image:
Name — how the image is listed in the media library. Make it searchable: Minister opening the bridge, March 2026, not IMG_4021.
Image — upload the file, then fill in Alternative text. Describe what the image shows for someone who cannot see it. Drag the focal point marker onto the key subject so automatic crops keep it.
Tags — optional keywords to help find the image later.
Upload in bulk
On the media list choose Upload media in bulk (/media/bulk-upload/upload_media). Drop several images, videos, audio or other files at once and a media item is created for each, with the type chosen from the file extension. Documents are not included — add those one at a time.
Bulk-uploaded images have no alternative text. They appear in the Images missing alt text report; edit each one and add it.
Edit media
Open a media item from the list. You can rename it, change the alternative text, retag it, or use Replace file to swap the file while keeping everything else — the new file appears everywhere the media is used.
Delete media
Expand the operations button in the media list and choose Delete, or use Delete on the item's edit form. Authors can delete only media they uploaded; Approvers can delete any. Deleting a media item breaks every page that uses it, and there is no usage list editors can see — unpublish it first and watch for pages that lose an image, or ask a Site administrator to check the files list. On the confirmation, choose whether to delete the file from the file system as well as the media item.
Choosing existing media
Every Add media button on a form opens the media library. Search by name, filter by type, tick one or more items and choose Insert selected. The Add file field in the same dialog uploads a new item without leaving the page.
Last updated