Skip to main content

🖼️ Assets and media limits

This page explains supported formats, size guidance, CDN caching, and how assets update on devices so campaigns stay fast and reliable.

Leo avatar
Written by Leo
Updated over 5 months ago

Supported formats

Images

  • WebP recommended

  • JPEG and PNG supported

  • SVG for icons and logos if your experience supports it

Video

  • MP4 (H.264) recommended for widest Android 8 compatibility

  • WebM optional if your experience supports it

  • Audio tracks in AAC are supported inside MP4

Tip: Prefer WebP for photos and lightweight PNG or SVG for flat graphics.

Size and performance guidance

  • Keep images under 500 KB each where possible

  • Keep the total campaign size under 20 MB unless you include video

  • Large files slow device updates and can fail on poor networks

  • The CMS blocks files that exceed internal limits and warns if the campaign is too large

Video recommendations

Use these as practical defaults. Adjust if your design needs higher quality.

  • 1080p 30 fps: target 4 to 8 Mbps H.264

  • 720p 30 fps: target 2.5 to 5 Mbps H.264

  • Portrait kiosks: export in native orientation to avoid rotation at runtime

  • Keep loops short for smoother playback and quicker downloads

  • Avoid alpha channels in video unless strictly required

Thumbnails and previews

  • The CMS generates thumbnails and placeholder previews automatically

  • Use previews to confirm sharpness, crop, and orientation before publish

CDN and origin

  • Assets are stored on S3 and served through CloudFront

  • Caching follows the default S3 cache period

  • Replace assets with optimised versions rather than upscaling in the browser

How assets update on kiosks

  • Local images are cached by the service worker and update when the app updates

  • Cache invalidation runs when the device is online at any of these moments:

    • Session refresh every 10 to 15 minutes

    • Idle for 60 seconds

    • Service worker update when a new build is deployed

Devices will continue to show the last cached assets while offline.

Enterprise media processing

  • Optional server side image resizing and video transcoding can be enabled for enterprise

  • Talk to us if you need automatic renditions or stricter cache rules

Troubleshooting assets

  1. Image looks blurry
    Re-export at the kiosk’s display resolution. Prefer WebP. Keep under 500 KB.

  2. Video stutters
    Reduce bitrate or resolution. Aim for the ranges above. Confirm the site meets network guidance.

  3. New asset not appearing
    Ensure the device is online and allow a session refresh. If a build deployed, wait for the service worker update.

  4. Campaign slow to deploy
    Check total size under 20 MB. Recompress large images. Trim video duration or bitrate.

  5. Upload blocked
    The file exceeded limits. Compress and retry. The CMS shows the blocking reason during upload.

Did this answer your question?