Version Management

What Are Versions?

A Version is a snapshot of your game at a specific point in time. Versions let you iterate on your playable ad while keeping a complete revision history. Each version has its own assets, configuration, and export history.

Creating a Version

1. Open a game from the Games list
2. Go to the Versions tab
3. Click Create Game
4. Fill in the details:
   • Version Number (required) — e.g., 1.0.0, 2.1.0
   • Engine Type (required) — Select from:
     • Cocos Creator
     • Unity
     • Phaser
     • PlayCanvas
     • Construct 3
     • Defold
     • Custom Engine
   • Status — Draft, Testing, Approved, Published, or Archived
   • Version Name — Display name (defaults to "Version X.X.X" if left empty)
   • Description — Notes about what changed in this version
   • Version Notes — Internal notes for your team
   • Thumbnail URL — Optional preview image URL
5. Click Create New Version

Tip: Use semantic names that indicate the purpose — v1.0-initial, v1.1-new-cta, v2.0-holiday-theme.

Version List View

The versions tab shows all versions for a game with:

• Version name and description
• Created date and last modified
• Export status — Which networks have been exported
• Variant count — Number of variants created from this version

Working with a Version

Opening a version gives you access to three main tabs:

Variants Tab

• Create and manage customized variants
• Filter variants by status (All, Active, Draft, Archived)
• Customize parameters for each variant
• Preview and share variants
• Duplicate variants for testing

Localization Tab

• Configure translations at the version level
• Override parameter values per language
• Applies to all variants unless overridden at variant level
• Supports text, audio, and image localization

Networks Tab

• Upload network-specific builds generated by Super HTML
• Two methods for parameter configuration:
  • Upload JSON file — Select a .json parameter file
  • Editor JSON — Paste and edit JSON directly with Monaco editor
• Real-time upload progress with Server-Sent Events (SSE)
• Displays available networks after upload
• Add additional network builds anytime

Creating a Version from an Existing One

To branch from an existing version:

1. From the game detail page Versions tab, find the version to duplicate
2. Open the version actions menu (three dots)
3. Select Duplicate
4. Enter a new version number (e.g., 1.1.0 if duplicating 1.0.0)
5. Click Duplicate Version

The new version inherits all configuration from the source. This is useful when you want to make incremental changes without modifying the original.

Version Status Lifecycle

Each version has a status indicating its stage in the workflow:

You can change the status anytime by editing the version.

Branching Strategy

A recommended approach for managing versions:

Best Practices

• Keep production versions clean — Do not modify a version after exporting it for production
• Duplicate before editing — Create a new version for changes rather than editing an exported one
• Use descriptive names — Include the purpose or change in the version name
• Archive old versions — Hide versions that are no longer active

Deleting a Version

Warning: Deleting a version permanently removes all its variants, exports, and stored files from cloud storage. This cannot be undone.

1. Open the version menu (three dots)
2. Select Delete
3. Confirm the deletion

Next Steps

• Create variants from a version for network-specific builds
• Export your playable ad to target ad networks