Where media lives
Images and documents live in the file manager (Content » Files), not inside a page. Upload once and use the file in as many places as you need.
A file's address stays the same when you upload a new version of it: the file manager keeps each upload as a revision, so pages that use the file show the new version and their links keep working. That is the main reason to upload properly instead of pasting images into text.
Before you upload
- Size images for the web. A photo straight from a phone or a camera can be several megabytes. Resize it to about the largest size it will be shown at; oversized images are the most common cause of slow pages.
- Give the file a real name.
team-photo-2026.jpgcan be found in six months;IMG_4471.jpgcannot. The name becomes part of the file's address. - Pick the right format. Photographs as JPEG; screenshots and graphics with flat colour or text as PNG; logos and icons as SVG where the site supports it.
Alt text
Give every image its alt text in the file manager's metadata panel. Screen readers announce it, and it shows if the image cannot load.
Describe what the image tells the reader, not what it literally shows: "Support team on a video call" beats "photo of four people". An image that is purely decoration should have no alt text, which tells a screen reader to skip it.
Documents
PDFs and other documents work the same way. When you link to one, keep its name meaningful and say the format and size in the link: "Annual report (PDF, 2 MB)" rather than "download".
Anything in the file manager can be opened by anyone who has its address, so do not upload a file you would not publish. Your developers can set up downloads for signed-in members when a file must stay private.
Replacing a file
A new version of a file changes it everywhere it is used at once. That is powerful and occasionally surprising: if the file appears on pages you do not look after, check before replacing it. When the new file is meaningfully different, uploading it under a new name is often safer.