Image style guidelines | 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. [Images, video & documents management](/articles?category=10) › 4. Image style guidelines Image style guidelines ====================== Updated 5 days ago · 3 min read Search Search Overview -------- You do not need to resize or crop an image to a specific pixel size before uploading it. The site crops it automatically to whatever ratio each component needs, and the same image can be cropped differently in different places. What you do control is the **focal point**: the part of the image that stays in frame however it gets cropped. --- Before you upload ----------------- What On this site File types JPG, JPEG, PNG, GIF and WebP. Alt text Required. The form will not save without it. File size Shown on the upload screen, under Select files. It is far more than any photo needs. Dimensions No minimum and no maximum. Around 2000px on the longest edge covers every crop. > **⚠️ Important:** Alt text describes the image for people using a screen reader, and for anyone whose image does not load. Write what the image shows, not the file name. A decorative image still needs the field filled in, so describe it briefly. ![The Alternative text field on a media item, marked as required, filled in with a short description of what the photograph shows.](/storage/dfpkpsUoJ2d7Zz4pmgR09VYLPSVpt9OfJ7o3LjYn.png) > **💡 Note:** SVG files use a separate media type, **SVG Image**. They are not cropped or converted, so the focal point does not apply to them. --- Setting the focal point ----------------------- When you upload or edit an image in the media library, it appears with a small **+** marker over it. ![An image in the media library edit form with the focal point marker over its main subject.](/storage/jFGRgBtBe7qsVA4bVw8INcZSxYrjcR65QffVSuGL.png) 1. Click the part of the image that matters most: a face, a headline feature, the centre of the action. 2. The marker moves to that point. 3. Press **Save**. Wherever this image is used, the site crops toward that point first. A landscape photo used in a tall, narrow component keeps the area around your marker and trims the rest. > **💡 Note:** If you never set one, the site uses the centre of the image. That works for a lot of photographs, so a focal point is worth setting when the subject is off centre rather than on every image you upload. --- What the site does to your image -------------------------------- One upload is reused everywhere. The site makes its own copies at the size and shape each place needs, and your original is left untouched. - **It crops to eight shapes**: 1:1, 3:2, 4:3, 16:9 and a wide 5:2 band, plus the upright 2:3, 3:4 and a tall 9:16 panel. Each has several sizes behind it, so a phone is not sent a desktop-sized file. - **It converts the file**. Whatever you upload, visitors are served a modern, smaller format. This is automatic and you do not choose it. - **Some places do not crop at all**, and simply scale your image to fit the width. So there is no need to save a web-optimised copy before uploading. Upload the largest, least cropped version you have and let the site do the rest. > **💡 Note:** If your subject sits hard against one edge of the original photo, some shapes will not have room to include it even with the focal point set well. A little breathing room gives every crop something to work with, and it matters most at the extremes: a photograph that suits the wide 5:2 band rarely suits the tall 9:16 panel without losing something. ### Sharing on social media The site has image sizes ready for link previews: 1200 by 630 for Facebook and 1600 by 900 for X, both cropped using the focal point. At present they are not used. Pages do not yet tell social media which image to show, so a shared link uses whatever image the platform picks from the page. See [**Meta tags and search appearance**](/articles/meta-tags-and-search-appearance). > **💡 Tip:** If an image looks wrong in one place but fine everywhere else, check its focal point before assuming the photo itself is the problem. Related articles ------------------ - [ Adding images, documents and video → ](/articles/adding-images-documents-and-video) - [ Site components overview → ](/articles/site-components-overview) - [ 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 Images, video & documents management ](/articles?category=10) 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)