Skip to content

Images

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.

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.

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.

  1. Resize so the longest side is at most 2000 px.
  2. Save as JPG at 75–85 % quality.
  3. 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.

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).

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 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.

Want to place your own image on top of the map, such as an indoor plan or a drawn trail? See Custom map image.

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.