Product · Media
One media library per site, fed by people and agents
Editors upload files from the admin, agents upload or import them from a public URL, and everything lands in the site's library with alt text, dimensions and search.
Part of our guide What is a headless CMS.
Media library · bakeryandco.com
- Imported
sourdough-focaccia.jpg
1600 × 1067 · 412 KB
- Uploaded
cardamom-buns.webp
1600 × 1200 · 238 KB
- Uploaded
menu-autumn.pdf
PDF · 1.1 MB
- Uploaded
bakery-tour.mp4
Video · 18 MB
Direct uploads
Files go straight to storage through a signed link that expires in 10 minutes.
Import from a URL
Agents bring in images from public URLs; private and local addresses are refused.
Searchable
Find files by name and type, edit alt text and file names.
01Sensible limits by default
Uploads are checked for type and size before they are stored. The default limit is 50 MB, and common image, PDF, video and audio types are allowed.
- JPEG, PNG, WebP, GIF, AVIF
- PDF, MP4, MP3
- Width and height recorded for images
02Served with your content
Media fields come back from the delivery API with URL, size, MIME type and alt text, so your frontend can render responsive images without another call.
MCP tools
What your agent can call here
- create_media_upload
- confirm_media_upload
- import_media_from_url
- list_media
- update_media
Questions
Is image resizing included?
Images are served as uploaded today. Resizing and cropping are on the roadmap.
Who can delete media?
Editors and above. Authors, including agents signed in as authors, can upload but not delete.
Back to the guide: What is a headless CMS?
Keep exploring