Two ways an image gets onto a page
- An Image area is a field of its own on a layout or a component. The template decides how the image is shown: its size, its cropping, how it behaves on a phone. You choose the picture; the design does the rest.
- An image inside rich text sits in the flow of the text, at whatever size the editor recorded, without the design's help.
Prefer the Image area
When a layout or a component offers an Image area, use it. Images placed through an area stay consistent with the design, adapt to small screens, and can be swapped without touching the text.
Images in rich text are for pictures that belong in the middle of the writing: a screenshot illustrating a step, a diagram between two paragraphs.
Upload first, then insert
An image pasted from a document or another website may not be in the file manager at all: it still points at wherever it came from, looks fine on the day, and breaks when that copy moves or expires. Upload the image to the file manager, then insert it from there. When you copy content from elsewhere, treat the images as a separate job.
Sizing images in rich text
Do not resize an image by dragging its corner in the editor. That fixes a width that will not adapt to a phone, and the visitor still downloads the full file. Upload the image at the size you want to show it.
Linking to documents
Link to a document by choosing it from the file manager rather than pasting an address copied from somewhere. A file's address survives a new version of the file; an address copied from elsewhere may not.