Meta playable ads: specs for Facebook and Instagram
A Meta playable ad is an HTML file of up to 2 MB, or a ZIP of up to 5 MB with no more than 100 files. It must work without mraid.js, makes no external requests, and calls FbPlayableAd.onCTAClick() for its call to action. Every playable comes with a companion video, and it runs only under the app promotion objective.
Below are Meta’s rules, the store call, the placements and how to check a playable before upload.
By Arc Studio · Updated
Meta playable ad requirements
The four things a build has to get right before it can run
Package
- Meta
- Single HTML with data-URI assets, or ZIP with index.html (up to 100 files)
Max size
- Meta
- 5 MB ZIP; 2 MB HTML file
MRAID / API
- Meta
- No MRAID: must work without mraid.js
Store click
- Meta
- FbPlayableAd.onCTAClick()
Meta’s rules for playables
From the network’s own documentation
- A single HTML file, or the index.html inside a ZIP, may be up to 2 MB; the ZIP up to 5 MB and 100 files.
- No external network calls (XMLHttpRequest is not allowed) and no JavaScript redirects.
- Built in portrait orientation and responsive.
- Needs a companion video; app promotion objective only; runs in Facebook and Instagram Feed, Stories, Reels and Audience Network.
The Meta call to action
Meta rejects a playable whose call to action does not use this function
installButton.addEventListener(
"click",
() => FbPlayableAd.onCTAClick(),
);Where Meta playable ads run
- Placements. Facebook Feed, Facebook Stories, Instagram and Audience Network, as listed in Meta’s developer documentation.
- Companion video. Every playable ad carries a companion video that plays before it. Meta notes that companion videos are not shown in Audience Network placements.
- Objective. Playables run only under the app promotion objective.
- Orientation. Built in portrait and responsive to the screen.
How to test a Meta playable
Meta introduced a Playable Preview Tool for validating playable assets before upload. Meta’s documentation also notes that playable ads cannot be tested on iPads, so test on a phone.
Before uploading, check the limits Meta rejects on: an HTML file or index.html over 2 MB, a ZIP over 5 MB or over 100 files, and a call to action that does not use FbPlayableAd.onCTAClick().
Split-Test Sprints & Pricing
Stop buying single HTML5 files. Every sprint ships as a complete testing kit with built-in funnel analytics, no-code balance configs, and multi-network builds.
AI Prototype Fix
Vibe-to-Prod Rescue
flat fee
- Turnaround
- 48–72 hours
- Best for
- Teams generating raw prototypes in Cursor or Claude that suffer from lag, heavy file sizes (>5 MB), or ad network validation errors.
What you get
- Clean refactor on Cocos Creator or PixiJS
- Game feel polish (tweens, particles, tactile feedback)
- Strict compression (<2 MB for Meta, <5 MB for others)
- Packaged & validated for up to 8 ad networks
Most Popular · Flagship
Pilot Sprint
~$45 per localized build
- Turnaround
- 5 days
- Best for
- Mobile games & non-gaming apps (fintech, utilities, dating) looking to find a winning UA creative fast without burning budget.
What you get
- 1 custom concept + 2 opening hooks
- 4 endcard variations × 5 languages (20+ builds)
- No-Code Tweaker (adjust speed, difficulty & CTAs yourself)
- In-playable drop-off funnel analytics
- Bonus: 3 vertical video hooks recorded in-engine
- Packaged for up to 8 ad networks (Meta, AppLovin, Mintegral, Unity, Google, ironSource, Moloco)
iGaming & Acquisition
Gamified Pre-Lander
flat fee
- Turnaround
- 5 days
- Best for
- Licensed iGaming operators, betting & high-converting web funnels running Meta, TikTok, Push, or Native traffic.
What you get
- Custom mini-game (<1.5 MB, <1s load on 3G/4G)
- Programmable win-logic & bonus funnel (4 win modals)
- Full SubID / UTM / click_id pass-through
- Server/pixel event firing (Meta, TikTok, Keitaro, Binom)
- 5 languages + No-Code config (swap logos, bonuses & links)
No prepayment. You pay after the sprint is delivered.
Need High-Craft 3D or High-Volume Scaling?
Request Custom ScopeHigh-Craft 3D Sprint
7–10 daysFrom$1,600
Custom 3D scenes, physics, and shaders in Cocos 3D or Three.js (like Bottle Jump 3D or Train of Hope), including the full Pilot Sprint testing kit.
Scale Pack
10–12 days$2,400
For UA teams spending $30k+/mo. 3 original concepts × 3 variations, creative hypothesis matrix, 1 post-test iteration round, and 9 in-engine video hooks.
What's included
Standard engineering & analytics stack included in every sprint
Ex-Playrix Game Design
Mechanics engineered around 3-second hooks and IPM lift, not generic templates.
No-Code Balance Tweaker
Change game speed, win thresholds, and CTA copy in seconds without touching code.
In-Playable Funnel Tracking
See exact user drop-off points: load, first tap, 5s, win/fail, store click.
Guaranteed compliance with MRAID and network file-size limits out of the box.
Meta playable ads FAQ
Quick answers for Facebook and Instagram playables
What is the maximum size of a Meta playable ad?
A single HTML file, or the index.html inside a ZIP, may be up to 2 MB. A ZIP may be up to 5 MB and hold at most 100 files.
Do Meta playable ads use MRAID?
No. A Meta playable must work without mraid.js, and its call to action uses FbPlayableAd.onCTAClick().
Do Facebook playable ads need a video?
Yes. Meta playable ads carry a companion video. Meta notes that the companion video is not shown in Audience Network placements.
Where do Meta playable ads run?
Facebook Feed, Facebook Stories, Instagram and Audience Network, under the app promotion objective.
How do I test a Facebook playable ad?
Meta provides a Playable Preview Tool for validating playable assets. Test on a phone: Meta’s documentation notes that playable ads cannot be tested on iPads.
Can one playable build run on Meta and other networks?
Not as is. Networks differ in the package (single HTML or ZIP), the store-click call and the required hooks, so each network needs its own build. Arc Studio delivers a ready-to-ship archive for every ad network you need.
Playable ad specs for 8 networksHow much does a playable ad for Meta cost?
Arc Studio sells playables as split-test sprints, not single files. A Pilot Sprint is $950 for 20+ playable builds (1 concept, 2 hooks, 4 endcards × 5 languages, about $45 per localized build) in 5 days; a Vibe-to-Prod Rescue of an AI-generated prototype is $600 in 48–72 hours; a Gamified Pre-Lander for iGaming and web funnels is $1,100 in 5 days; a High-Craft 3D Sprint starts at $1,600 (7–10 days) and a Scale Pack is $2,400 (10–12 days). No prepayment. You pay after the sprint is delivered. Every sprint ships builds for Meta and up to 8 ad networks in all, and includes Ex-Playrix game design around 3-second hooks and IPM lift, a no-code balance tweaker, in-playable drop-off funnel tracking (load, first tap, 5 seconds, win or fail, store click) and builds that meet MRAID and network file-size limits.
Playable ad cost, explained