PlayableLabs Docs
Games

Games Overview

Understand the Game hierarchy in PlayableLabs and how Games, Versions, and Variants work together

The Game Hierarchy

PlayableLabs organizes every playable ad project into three levels:

Game
 └── Version
      └── Variant
  • Game — The top-level project representing a playable ad campaign
  • Version — A snapshot of the game at a specific point in time
  • Variant — A customized copy of a version tailored for a specific ad network or audience

This structure lets you manage multiple iterations, run A/B tests, and produce network-specific builds from a single project.

When to Use Each Level

LevelPurposeExample
GameGroup all work for one campaign"Puzzle Quest Summer 2026"
VersionTrack major revisions"v1.0", "v2.0-holiday"
VariantCustomize for a network or test"Meta - English", "Google - Japanese"

Games

Create a new Game for each distinct playable ad campaign. Games hold all versions, assets, and settings in one place.

Versions

Create a new Version when you make significant changes to gameplay, visuals, or assets. Previous versions remain untouched, giving you a full revision history.

Variants

Create Variants from a Version to customize the ad for different ad networks, locales, or A/B testing scenarios. Each variant can override assets, text, and configuration without affecting the parent version.

Dashboard Overview

The Games page displays all games in your organization. From here you can:

  • Search and filter — Find games by name or tags
  • Sort — Order by name, date created, or last modified
  • Quick actions — Create, duplicate, or archive games
  • View details — Click a game to see its versions and variants

Tip: Use tags to organize games by client, campaign type, or status (e.g., active, archived, client:acme).

Game Detail View

Opening a game shows:

  • Overview tab — Game name, description, tags, and metadata
  • Versions tab — All versions with status and export history
  • Assets tab — Uploaded media files (images, audio, data)
  • Settings tab — Game-level configuration and defaults

Next Steps

On this page