Try for free
Learn/Specs by network

TikTok playable ad specs

TikTok's 2026 playable rules: ZIP under 5 MB with index.html and config.json, the TikTok Playable SDK, window.openAppStore, orientation and testing.

Written by Yonathan Avivi, Head of Marketing, Genie Labs

Technical review by Yotam Wolf, CTO · Published Oct 8, 2026 · Last verified Sep 30, 2026 · 5 min read

TikTok accepts playable ads as a ZIP under 5 MB after compression, with an index.html and a config.json in the top-level folder. The playable loads TikTok's Playable SDK and calls window.openAppStore for the click to the store. It must not use the mraid.js format and can't make HTTP requests, load assets dynamically or redirect with JavaScript. Orientation is set in config.json. The same specs cover TikTok Ad Network, formerly Pangle.

Key takeaways
ZIP under 5 MB, with index.html and config.json at the top level.
Load the TikTok Playable SDK at the bottom of the body, before your own JavaScript.
Click out with window.openAppStore. No mraid.js.
Orientation lives in config.json: 0 flexible, 1 portrait, 2 landscape.
Genie Playable exports a TikTok-ready ZIP, config and SDK included, from the same source as your other networks.

What are TikTok's playable ad requirements?

RequirementTikTok's rule
FileZIP, under 5 MB after compression
Contentsindex.html and config.json in the top-level folder
OrientationSet in config.json: 0 = flexible, 1 = portrait, 2 = landscape
SDKLoad https://sf16-muse-va.ibytedtos.com/obj/union-fe-nc-i18n/Playable/sdk/Playable-sdk.js at the bottom of the body, before your own JavaScript
Click to storewindow.openAppStore
MRAIDMust not be in mraid.js format
External requestsNo HTTP requests, no dynamic loading, no JavaScript redirects
CoverageTikTok ads and TikTok Ad Network (formerly Pangle)

What goes in config.json?

The config file tells TikTok how to display the playable. The field TikTok documents is orientation: 0 for flexible, 1 for portrait, 2 for landscape. For most TikTok placements, portrait (1) or flexible (0) is the safe choice. Keep the file at the top level of the ZIP next to index.html, not inside a subfolder.

How is TikTok different from other networks?

TikTokSnapchatMetaAppLovin
FormatZIP + config.jsonZIP + config.jsonHTML or ZIPSingle HTML
Click-outwindow.openAppStoreScPlayableAd.onCTAClickFbPlayableAd.onCTAClickmraid.open
SDK or MRAIDTikTok Playable SDK; no mraid.jsNot requiredNo mraid.jsMRAID 2.0 required
OrientationSet in configPortrait onlyPortrait firstBoth

TikTok and Snapchat look similar at first glance: both want a ZIP with a config.json. The click-out calls are different, so they still need separate builds.

Config, SDK and click-out, handled. Genie Playable packages every playable for TikTok with config.json and the Playable SDK in place, next to your Meta, AppLovin and Unity Ads builds.

Try it free on your game

How do I test a TikTok playable?

01Check the ZIP: index.html and config.json at the top level, under 5 MB compressed.
02Confirm the SDK script sits at the bottom of the body, before your own scripts.
03Search the code for "mraid" and "http" (other than the SDK URL). Neither should be there.
04Upload in TikTok Ads Manager and use the preview.
05Note that the jump to the app store doesn't work in preview. Test the CTA wiring in code, and check the live ad once it's approved.

What are the common TikTok playable mistakes?

·config.json missing or placed inside a subfolder.
·SDK loaded in the head or after your own scripts.
·The Meta build reused as is, with FbPlayableAd.onCTAClick instead of window.openAppStore.
·An MRAID build uploaded to TikTok.
·Expecting the store jump to work in preview.

Where does Genie fit?

Genie Playable builds playables from your game (your APK or HTML build plus the assets, narrative and live events in Genie), from a format that's already working, or from a brief. Every playable exports as a TikTok-ready ZIP and as versions for Meta, AppLovin, Unity Ads, Liftoff, Google Ads, Pangle and Mintegral (Moloco coming soon), all from one source. Try it free on your game.

FAQ

Sources

  1. 01TikTok Ads Manager help, playable ads
  2. 02Snapchat Business Help, App Playables
  3. 03Meta Business Help, playable ads

Keep reading

All articles →
Playable ads · 7 min read

Playable ad specs by network (2026): size limits, MRAID and file format

Playable ads · 6 min read

Meta playable ad specs: Facebook, Instagram and Audience Network

Playable ads · 6 min read

Google Ads and AdMob HTML5 playable specs

Ready to ship playables from your game?

Try for freeBook a demo

How to make a playable ad from your own game (without rebuilding it)

Three ways to turn your game into a playable ad: engine export, HTML5 rebuild, or building from your APK. Steps, specs, testing and mistakes to avoid.

Written by Yonathan Avivi, Head of Marketing, Genie Labs

Technical review by Yotam Wolf, CTO · Published Sep 26, 2026 · Updated Sep 26, 2026 · 11 min read

A playable ad from your own game is a 30 to 90 second interactive slice of your game: your characters, your art and one clear mechanic, packaged as a small HTML5 file an ad network can run. You can't ship your game build as it is. Networks cap playables at about 5 MB in a single HTML file or ZIP, with strict rules on code and clicks. So you have three options: export a stripped-down scene from your engine, rebuild the moment in an HTML5 framework, or use a tool that builds the playable from your game's build and assets. This guide walks through all three.

Key takeaways
{{ k }}

What does "a playable ad from your own game" actually mean?

It means the player sees your game, not a generic template with your logo on top. Studios that do this well keep three things fixed and treat the rest as open.

Keep fixedOpen to change
{{ r.ak }} {{ r.av }}{{ r.bk }} {{ r.bv }}

This matches what UA and creative leads tell us. Brand fidelity is non-negotiable. Gameplay is often borrowed from whatever is trending. The catch is policy. The UK ASA now treats even a genuine but non-core mechanic as potentially misleading, and Google Play bans ads that don't represent the app. The closer your playable is to what players actually get, the safer it is, and the better it tends to retain.

Why can't I just ship my game build as a playable?

Ad networks run playables inside their own ad containers, not as apps. Every playable has to fit this box:

SizeAbout 5 MB on every major network (AppLovin, Meta, Google, TikTok, Unity, Mintegral, Moloco, Snapchat). A WebGL export of a real game is usually far bigger. An empty Godot export is already over the limit.
FormatOne self-contained HTML file with every asset inlined (AppLovin, Unity, Moloco), or a ZIP with an index.html (Google, TikTok, Mintegral, Snapchat). Meta accepts both.
No external callsNothing loads from your servers at runtime.
Click-out callmraid.open() on AppLovin and Unity, FbPlayableAd.onCTAClick() on Meta and Moloco, ExitApi.exit() on Google, window.openAppStore() on TikTok, window.install() on Mintegral.
Behavior rulesMuted until the first interaction, no store redirect on the first tap, no auto-redirects, works in portrait and landscape.

The full list lives in our Playable ad specs by network (2026).

What are the three ways to turn my game into a playable?

1. Engine export 2. HTML5 rebuild 3. Build from your APK or HTML and assets
{{ r.k }} {{ r.a }} {{ r.b }} {{ r.c }}

Most studios mix routes: a hand-built hero playable for a launch, and faster tooling for the weekly variations that keep a campaign alive.

What buyers expect to pay and wait: roughly $3,000 to $8,000 and two to four weeks per new playable from an external studio, and roughly $600 to $2,000 in-house once the setup exists. Nobody has a clean source for these numbers, so treat them as market expectations. One mid-size studio we spoke to put it simply: the market norm is "two weeks onwards", and their target is under a week.

Your game is already the brief.

Upload your APK or HTML build. Genie Playable turns it into a playable ad with your own art, characters and live events, ready for 10 ad networks.

Try it free on your game

How do I make a playable ad from my game, step by step?

01\Pick the moment worth playing

Choose one mechanic a stranger understands in three seconds. Good sources: your core loop at its most satisfying, the live event running now, or a format already converting in your genre. If you can't explain the moment in one sentence, it's too complex. One mechanic beats two.

“Merge plus puzzle looks clever and almost always tests worse.”
Segwise

02\Script the arc

Almost every playable follows the same shape:

{{ a.n }} {{ a.k }} {{ a.v }}

03\Prepare your assets

Export characters, backgrounds, UI and sounds from your game, then cut hard. Compress images, use sprite sheets, trim audio to short loops and subset fonts. Base64 inlining adds about a third to file size, so aim for 2 to 3 MB in total and treat 5 MB as the ceiling.

04\Build it

Whatever route you use, keep the logic in plain HTML and JavaScript, make the layout work in 9:16 and 16:9, and keep sound off until the first tap.

05\Package it for each network

This is where engineer time quietly disappears. "A unit that passes on AppLovin can bounce on Unity," as Segwise puts it. Each network needs the right file format, the right click-out call and any required hooks. Mintegral, for example, expects gameReady() and gameEnd() calls. Build once and generate network variants from one source. Hand-editing copies is how bugs creep in.

06\Test before you upload

{{ t.k }}{{ t.v }}

Then test on a real low-end Android phone. A desktop browser hides most of the problems.

07\Launch and measure

Give each playable enough data before you judge it. A common rule of thumb is about 50 conversions in four days, or 100 in seven. Judge on D7 ROAS and retention, not CPI alone. If you can, add events inside the playable (start, first interaction, win or lose, CTA tap, drop-off point), because network dashboards only show the last step.

08\Plan the next version before this one fatigues

Top-grossing games ship dozens of new playables a month, and most of that volume is variations of a winner. Leading teams put roughly 70% of output into variations and 30% into new concepts. Decide now which single thing you'll change next: the hook, the fail state, the character, the event skin or the end card.

What should I keep from my game, and what can I borrow?

Keep everything that helps a player recognise your game after install: art, characters, UI language, sound. Borrow structure freely, whether that's a proven hook, a pacing pattern or a format working in another genre. Racing and narrative studios often tell us their game "isn't playable". The honest read: a playable doesn't need your full core loop. It needs one true moment from your world.

What are the most common mistakes?

Mistake What happens Fix
{{ m.a }}{{ m.b }}{{ m.c }}
The next version, not a new brief.

When a playable fatigues, Genie Playable lets your UA or creative team change the hook, the character or the event skin on the last version and ship it again. No dev queue.

Book a demo

Where does Genie fit?

Genie Playable takes the third route, and adds two more ways in. You can build from your game: your APK or HTML build together with the assets, narrative, mechanics and live events already in Genie. You can start from a format that's already working and rebuild it with your game inside. Or you can start from scratch and describe the playable to Genie Agent.

Genie Core keeps every version on brand, and Genie Playable exports network-ready variants for Meta, AppLovin, Unity Ads, Liftoff, Google Ads, TikTok Ads, Pangle and Mintegral from one source, with Moloco coming soon. No developer is needed at any step, and your team makes the final call on every version. Sign-up is free and covers your first two playables. Try it on your game.

Where to go next

First playable? Follow how to make a playable ad step by step, then run it through the playable ad best practices checklist. Once it's live, read how to know if your playable ad is working and how to A/B test playable ads.

FAQ

{{ f.a }}

Sources

  1. {{ s.n }}{{ s.name }}

{{ a.h1a }} {{ a.h1b }}

{{ a.desc }}

Written by {{ a.author }}

{{ a.meta }}

Ready to ship playables from your game?