Domma CMS User Manual

Media

Updated by Darryl Waterhouse on 29 September 2026 1 min read

Media files are managed at Content > Media, stored in content/media/ and served publicly at /media/{filename}. Anything uploaded there can be opened by anyone who has its address - do not upload private documents.

Uploading

Use the upload button in the banner, or drop files onto the screen. Uploading a file with the same name as one already there replaces it; you are asked first. Accepted types are images (JPEG, PNG, GIF, WebP, SVG, ICO, BMP, TIFF), PDF, text and CSV, Word and Excel documents, MP4, WebM and Ogg video, and MP3, Ogg, WAV and WebM audio.

Working with a file

Click a file for its details: its address, a snippet to paste into a page, a rename box, and - for pictures - the image editor (crop, resize, rotate, flip, colour presets, adjustments, watermark, border, and saving as JPEG, PNG or WebP, as a copy or over the original). Right-click a file (or use its row menu) for the same actions without opening it.

Wherever the admin asks for a picture (SEO share images, a logo, some plugin settings) the Choose... button opens the Media Picker, where you can also upload.

Using media in pages

Reference uploaded files by their public URL in Markdown or HTML:

![Alt text](/media/my-image.jpg)
<img src="/media/my-image.jpg" alt="Alt text">

Always give pictures alt text - SEO's audit checks for it.

Upload limits

The largest file is set in config/server.json under uploads.maxFileSize (bytes). The default is 10 MB. File names are limited to 200 characters and cleaned of unsafe characters.