Adding images, documents and video | Doghouse SaaS Knowledge Base [Skip to content](#main) [ ![Doghouse SaaS Knowledge Base](/storage/branding/01M3N8PQ7PSDNQBBKKJM6XGW03.svg) ](https://nginx.deploy-lagoon-production.districtcms-docs.dh1.amazee.io) [Product documentation](/articles) [Roadmap](/roadmap) Toggle navigation [Product documentation](/articles) [Roadmap](/roadmap) 1. [Home](/) › 2. [Product documentation](/articles) › 3. [Creating & editing](/articles?category=17) › 4. Adding images, documents and video Adding images, documents and video ================================== Updated 5 days ago · 4 min read Search Search Overview -------- The editor has two buttons for pictures, and they do different things: Button What it does Insert Media Opens the media library. The file becomes a single item that many pages can point at, so replacing it once updates every page using it. Upload image from computer Puts a picture straight into this one text box. It is not added to the library, so it cannot be reused or replaced in one place later. Use **Insert Media** for anything that might appear on more than one page, and for all documents and video. The rest of this article covers it. --- What the library holds ---------------------- Five kinds of file, and the library keeps them apart so you are not scrolling past videos looking for a photo: Kind Use it for Image Photographs and pictures. Document A PDF, a form, a report. The page shows a link the reader can download. PDF, Word, Excel, PowerPoint, plain text and rich text files are accepted, as are OpenDocument files and Apple Pages, Numbers and Keynote files. Remote video A YouTube or Vimeo video, added by pasting its address rather than uploading a file. Videos from other websites cannot be added this way. SVG Image Logos and icons that stay sharp at any size. Video A video file held on the site itself. MP4 files only. --- Putting a file into a page -------------------------- The steps are the same whether the file is already on the site or you are adding it now. 1. Put the cursor where you want the file to sit. 2. Press **Insert Media**. The **Add or select media** window opens. 3. Choose the kind of file down the left-hand side. 4. Either tick an item that is already there, or add a new one with **Select files** under **Add file**. An image also needs alternative text, and the form will not let you finish without it. 5. Press **Insert selected**. ![The Add or select media window, with the five file kinds down the left, the Add file area and the filters for finding an existing file.](/storage/QMqX0maL74OrchrEMG1rIDbZquuOtT3z0lq4I388.png) > **💡 Note:** Give a file a name that describes it before you save it to the library. The name is how you and everyone else will find it again, and a library full of files called DSC\_0481 helps nobody. --- Alternative text ---------------- Every image needs alternative text, a short description of what the picture shows. It is read aloud to anyone using a screen reader, and it appears if the image fails to load. Describe what the picture shows, not what it is: - Good: Two people reading a notice board outside the community centre. - Poor: image, photo1, community centre jpg. The library will not save an image without it, so it is worth writing a good one the first time. --- Captions and position --------------------- Once a file is in the page, click it and a small toolbar appears. The buttons are icons with no labels, so here is what each one does, left to right: ![An image selected in the editor with its toolbar of seven controls outlined in red.](/storage/oYmYsdarPii476U36qM9vjqqz4vCLNPWl0tM9jEc.png) Control What it does Toggle caption Adds a caption line underneath the item, or removes one you have added. Use it for credits, dates or an explanation the picture needs. Link media Turns the item into a link, so a reader clicking the picture is taken somewhere. Override media image alternative text Changes the alternative text for this one placement, without changing the file in the library. Break text The item sits on its own line, with text above and below it. Align left and wrap text The item sits on the left and text flows around its right-hand side. Align center and break text The item is centred on its own line, with no text beside it. Align right and wrap text The item sits on the right and text flows around its left-hand side. > **💡 Note:** Wrapping text around a picture looks good on a wide screen and can look cramped on a phone, where the text column is narrow. If in doubt, choose **Break text** and let the picture have its own line. --- Documents behave differently ---------------------------- A document does not appear as a picture. It appears as a link the reader clicks to open or download. Two habits worth keeping: - Say what the document is in the surrounding text, so the reader knows what they are about to download. - Replace an outdated document by updating the item in the library rather than uploading a second copy. Every page pointing at it then shows the new version, and nobody is left reading last year's form. Related articles ------------------ - [ Glossary → ](/articles/glossary) - [ Using the editor → ](/articles/using-the-editor) - [ Image style guidelines → ](/articles/image-style-guidelines) - [ File and media management → ](/articles/file-and-media-management) Was this article helpful? ------------------------- Your feedback helps us prioritise what to rewrite. Yes No [ Back to Creating & editing ](/articles?category=17) On this page **Need additional help?** Submit a support request through the [**support portal** ](https://doghouse.atlassian.net/servicedesk/customer/portals)or email © 2026 [Doghouse SaaS](https://doghouse.agency) [Glossary](/articles/glossary)