PlayableLabs Docs
Reference

File Formats

Supported file formats for images, audio, and other assets.

Supported file formats for images, audio, and other assets.

Image Formats

FormatExtensionBest ForTransparency
PNG.pngLogos, icons, graphicsYes
JPEG.jpg, .jpegPhotos, backgroundsNo
GIF.gifAnimated overlays, simple animationYes (1-bit)
WebP.webpCompressed images/animation (smaller files)Yes

When to Use PNG

  • Logos and brand marks
  • Icons and UI elements
  • Graphics with text
  • Images needing transparent backgrounds
  • Clean edges and sharp lines

When to Use JPEG

  • Photographic backgrounds
  • Product photos
  • Lifestyle imagery
  • Large full-screen images (smaller file size)

iOS Compatibility & Unsupported Formats

Playable ads run in the WebView/Safari of each device, including old, low-end iPhones. PNG, JPEG, GIF, and WebP are allowed. The formats below carry iOS limits.

FormatiOS Minimum SupportUpload to Dashboard?Primary iOS Risk
PNG / JPEGAll versions✅ RecommendedNone
GIFAll versions✅ AllowedNone — animated GIF plays everywhere; heavy for its size, keep small
WebPiOS 14+⚠️ Allowed (iOS 14+)Renders blank on iOS < 14; animated WebP is memory-heavy — keep frame count/dimensions small
AVIFiOS 17+❌ Do NOT uploadBroken on iOS 16 & below; no progressive loading (blank until 100% downloaded)
HEIC / HEIFNative apps only❌ Do NOT uploadNo browser renders .heic in <img> — shows a broken-file icon for everyone
SVGHistorical❌ Do NOT uploadRejected if missing xmlns namespace; strict XSS sandbox

WebP renders blank on iOS below 14. It is allowed because the supported-device floor is iOS 14+, but if your campaign must reach older iPhones, use PNG or JPEG instead. Keep animated WebP/GIF small — they are memory-heavy on low-end devices.

Do NOT upload AVIF, SVG, or HEIC/HEIF. They fail or render blank on iOS. Convert them to PNG, JPEG, GIF, or WebP before uploading.

Size Guidelines

Logos

TypeSizeFormatMax File Size
Main Logo512 x 512 pxPNG500 KB
App Icon256 x 256 pxPNG300 KB
Small Icon128 x 128 pxPNG150 KB

Backgrounds

OrientationSizeFormatMax File Size
Portrait1080 x 1920 pxJPG/PNG2 MB
Landscape1920 x 1080 pxJPG/PNG2 MB
Square1080 x 1080 pxJPG/PNG2 MB

UI Elements

TypeSizeFormatMax File Size
Currency Icon64 x 64 pxPNG100 KB
Button Image256 x 128 pxPNG200 KB
Custom Icons128 x 128 pxPNG150 KB

Audio Formats

Playable ads run inside the WebView / browser of each ad network and on a wide range of devices, including old, low-end phones. Always upload an audio format that those devices can decode natively.

FormatExtensionUpload to Dashboard?Why
MP3.mp3✅ RecommendedUniversal — plays on every browser, Android, and iOS (including old/low-end devices). Hardware-decoded.
OGG Vorbis.ogg❌ Do NOT uploadNot supported on iOS before 18.4 (Safari/iOS WebView). Old and low-end iPhones play no sound. Also CPU-decoded, draining battery.

Do not upload .ogg (OGG Vorbis) audio to the dashboard. iOS only added native OGG playback in iOS 18.4 — every older iPhone and low-end device will play silence. Use MP3 instead. Reference: OGG Vorbis browser support

Audio Guidelines

TypeFormatRecommended BitrateMax File Size
Background MusicMP396–128 kbps500 KB
Sound Effect (win/lose, tap)MP396 kbps100 KB
Short SFX / UI blipMP364–96 kbps50 KB
  • Use mono for short sound effects — half the size of stereo, no audible difference for blips.
  • Keep music loops short and seamless rather than one long track.
  • Audio counts toward the overall playable size budget — compress aggressively.

Converting to MP3

If your source audio is not MP3 (e.g. .ogg), convert it before uploading:

ToolHow
Audacity (free)Open file → File → Export → Export as MP3
FFmpeg (CLI)ffmpeg -i input.ogg -b:a 96k output.mp3
Online (CloudConvert, Convertio)Upload → choose MP3 → download

Video Formats

For the entrance video and background video, upload MP4 (H.264) — it plays in the WebView on every device, including older iPhones.

FormatExtensionUpload to Dashboard?Why
MP4 (H.264).mp4✅ RecommendedUniversal WebView/mobile support, hardware-decoded
WebM / OGV.webm, .ogv❌ Do NOT uploadNo native playback on iOS Safari/WebView

Video Guidelines

SettingRecommendation
CodecH.264 (baseline/main profile)
Resolution720p or lower
LengthKeep short (2–5 seconds) — users must reach gameplay fast
File sizeUnder 1 MB ideal — video counts toward the size budget
  • Compress aggressively; a short, looping clip beats a long one.
  • Mute or keep audio minimal — many networks block autoplay audio.

Image Overlays (GIF / WebP)

For animated overlays you can upload an animated GIF or WebP in addition to static PNG/JPEG. Animation is preserved on upload (the file is stored as-is). Keep the frame count and dimensions small — animated images are heavy for their size, and animated WebP is memory-heavy on low-end iOS.

Color Formats

FormatExampleUsage
Hex (6-digit)#FF5722Standard colors
Hex (8-digit)#FF572280Colors with transparency

Hex Color Breakdown

#FF5722
  ^^ Red (FF = 255)
    ^^ Green (57 = 87)
      ^^ Blue (22 = 34)

#FF572280
        ^^ Alpha/Opacity (80 = 50%)

Preparing Images

Removing Backgrounds

For logos and icons with transparent backgrounds:

  1. Open in image editor (Photoshop, GIMP, Figma)
  2. Remove background
  3. Export as PNG-24
  4. Verify transparency in preview

Optimizing File Size

If your image is too large:

ActionReduction
Reduce dimensions~75% smaller
Increase JPG compression~50% smaller
Use PNG-8 for simple graphics~60% smaller
Use online compression tool~30-50% smaller

Color Profile

  • Use sRGB color profile
  • Don't use CMYK (for print)
  • Avoid embedded color profiles for smaller files

Troubleshooting

IssueCauseSolution
White box around logoNot PNG or transparency lostRe-export as PNG-24
Colors look wrongWrong color profileConvert to sRGB
Image pixelatedResolution too lowUse larger source
File won't uploadToo largeCompress or reduce size
Wrong dimensionsAspect ratio mismatchCrop to correct ratio

Tools for Image Preparation

Free Online Tools

  • TinyPNG - Compress PNG/JPG
  • Remove.bg - Remove backgrounds
  • Canva - Design and export
  • GIMP - Full image editing

Design Software

  • Adobe Photoshop
  • Figma
  • Sketch
  • Affinity Designer

Common Parameters

Parameters vary by playable. Below are parameters found in most builds.

Limits & Constraints

Reference for character limits, file sizes, and other constraints.

On this page

Image FormatsWhen to Use PNGWhen to Use JPEGiOS Compatibility & Unsupported FormatsSize GuidelinesLogosBackgroundsUI ElementsAudio FormatsAudio GuidelinesConverting to MP3Video FormatsVideo GuidelinesImage Overlays (GIF / WebP)Color FormatsHex Color BreakdownPreparing ImagesRemoving BackgroundsOptimizing File SizeColor ProfileTroubleshootingTools for Image PreparationFree Online ToolsDesign SoftwareRelated