Media & images
Images carry the emotional load of a site. Here is every place they appear, the rules that keep them honest, and the small habits that keep pages fast.
Where images live
| Place | Image role | Notes |
|---|---|---|
| Profile / avatar | Identity | Small, square, face-first |
| Blog posts | Cover + inline | Cover shows in the archive and share cards |
| Custom pages | Hero, figure, gallery | Alt text required on builder images |
| Projects | Media gallery | Captions per image |
| Design Studio | Canvas assets | Export at the size you need |
| vCard / QR | Branding | Logo center on QR codes |
Uploads and formats
Uploads are stored and served as-is from your site — the platform does not silently recompress your files. That is a feature: what you upload is what renders. The flip side is that the discipline is yours:
- Export at display size — a 600px-wide avatar does not need a 4000px original.
- Modern formats — WebP/AVIF where your export tool allows; PNG for logos needing crisp edges; JPG for photographs.
- One hero, not five — pages with a single strong image read better than pages with six competing ones.
Alt text is not optional
The page builder requires alt text on images — that is a floor, not a ceiling. Write alts that would describe the image to someone listening: "consultant sketching a user-flow diagram on a whiteboard", not "image1". Alt text is accessibility, it is what shows when an image fails, and it is one more honest signal to search engines.
Tip
The share card decides whether a pasted link gets clicked. Every page and post falls back sensibly — cover image first, then the page's first image, then a branded default — but setting the cover deliberately is one field and the difference between a link that looks alive and one that looks broken.
Galleries and lightboxes
Project galleries render with captions and open into a lightbox (the Image Lightbox plugin adds the full-screen view with keyboard navigation). Caption the images that need context; leave the obvious ones uncaptioned — captions are copy, and copy gets read.
When an image misbehaves
- Broken image icon — the URL is wrong or the upload failed; re-upload rather than editing the URL blind.
- Sideways / cropped wrong — the renderer preserves aspect ratio; fix the source image, not the page.
- Slow page — it is nearly always image weight; halve the largest image and feel the difference.
Note
Deleting media that is still referenced by a page leaves that page with a broken image. Remove the reference first (or replace the image), then delete the file — the full delete-safety picture is in Deleting content.