Images
Quick facts
Section titled “Quick facts”| Recommendation | |
|---|---|
| Format | JPG for photos. PNG for graphics that need transparency. |
| Size | 1600–2000 px on the longest side. Anything larger isn’t visible on a phone. |
| File size | Ideally under 500 kB per image, at most about 1 MB. |
| Proportions | Landscape, roughly 16:9. |
Why file size matters
Section titled “Why file size matters”The app uses the original file you upload. It is not scaled down automatically.
- The mobile app downloads every image and video in the app to the phone the first time it starts, and new or changed files when the content is updated.
- The web app loads images when the page is shown.
So a 10 MB photo takes as much space and mobile data as twenty reasonably sized JPGs. Large images make the app slower to get started.
Image formats at a glance
Section titled “Image formats at a glance”| Format | Good for | Pros | Cons | In the app |
|---|---|---|---|---|
| JPG (.jpg, .jpeg) | Photos | Small files, works everywhere. | No transparency. Loses a little quality each time it is re-saved. | Recommended |
| PNG (.png) | Logos, graphics, screenshots | Lossless, sharp text, can be transparent. | Photos get very large, often 5–10 times larger than JPG. | Works – for graphics |
| WebP (.webp) | Photos and graphics | Smaller than JPG at the same quality, can be transparent. | Not every image editor can open or save it. | Works |
| SVG (.svg) | Logos, icons | Vector graphics that stay sharp at any size, tiny files. | Only for drawn graphics, not photos. | Works – for logos |
| AVIF (.avif) | Photos | Even smaller files than WebP. | New format; doesn’t work on older phones or in many programs. | Avoid |
| HEIC (.heic) | iPhone photos | Small files. The iPhone’s default format. | Not shown on Android phones. | Doesn’t work – convert to JPG |
| GIF (.gif) | Simple animations | Can be animated. | Max 256 colours, large files. A short video is almost always better. | Avoid |
| TIFF, PSD, RAW | Print and photo editing | Highest quality, every detail kept. | Very large files, not shown on phones. | Doesn’t work – convert to JPG |
Lossy or lossless? JPG, WebP and AVIF discard details the eye hardly notices, which keeps files small. PNG, TIFF and RAW keep every pixel exactly – perfect quality but large files. For photos in an app, a lossy format is the right choice.
How to make an image the right size
Section titled “How to make an image the right size”- Resize so the longest side is at most 2000 px.
- Save as JPG at 75–85 % quality.
- Check that the file is under about 500 kB.
Tools:
- Squoosh – free, in the browser. Drop the image in, choose MozJPEG and set the size under Resize.
- Mac: open the image in Preview → Tools → Adjust Size, then File → Export as JPEG.
- Windows: open the image in Photos or Paint → Resize, save as JPEG.
iPhone photos are often saved as HEIC. Set the camera to Settings → Camera → Formats → Most Compatible, or export the image as JPG before uploading.
Cropping
Section titled “Cropping”Most images are shown in landscape. If you upload a portrait or square image it is cropped, and important parts may fall outside. Crop to 16:9 yourself before uploading, with the subject centred.
With Object Fit in the image’s Image Block you choose whether the image fills the whole area (cover – may be cropped) or is shown in full (contain).
Caption and copyright
Section titled “Caption and copyright”A caption can be shown under each image, for example the photographer’s name or a copyright line. Fill in Caption in the image’s Image Block. See Content blocks.
Alt text (accessibility)
Section titled “Alt text (accessibility)”Alt text is read aloud by screen readers (VoiceOver/TalkBack) for people with visual impairments. It isn’t visible in the app. Fill it in the Alt field when you upload the image in Media – once per language.
- Give every image that carries information an alt text, in every language.
- Alt text should serve the same purpose as the image – not just describe it. An arrow that leads to the next page should have the alt text “Next page”, not “Arrow pointing right”.
- Purely decorative images need no alt text.
Read more in Accessibility.
Images on the map
Section titled “Images on the map”Want to place your own image on top of the map, such as an indoor plan or a drawn trail? See Custom map image.
Images for the app shell
Section titled “Images for the app shell”App icon, splash, loading image and header are part of the app shell and are handled by OnSpotStory. See App graphics and store texts for sizes.
AI answers can be wrong – check the linked pages.
