PlayableLabs Docs
Games

Variants

Create network-specific and A/B test variants of your playable ad versions

What Are Variants?

A Variant is a customized copy of a version, tailored for a specific ad network, audience, or test scenario. Variants inherit everything from their parent version but let you override assets, text, parameters, and configuration without modifying the original.

When to Use Variants

Use CaseExample
Network customizationDifferent CTA button for Meta vs. Google
LocalizationEnglish variant and Japanese variant
A/B testingVariant A with blue theme, Variant B with red theme
Audience targetingCasual players vs. hardcore players

Creating a Variant

  1. Open a game and navigate to the version you want to customize
  2. Go to the Variants tab
  3. Click New Variant
  4. Fill in the details:
    • Name (required) — e.g., Meta - English, Google - Holiday Theme
    • Target Network — Select the ad network this variant targets
    • Description — Notes about what makes this variant unique
  5. Click Create

The variant starts as an exact copy of the parent version. You can then customize it independently.

Variant Status

Each variant has a status that tracks its lifecycle:

  • Draft — Work in progress, not ready for export
  • Active — Ready for export and deployment
  • Archived — Deprecated or no longer in use

You can change the status in the variant settings dialog. Use filters in the variant list to show only variants with a specific status.

Customizing a Variant

After creating a variant, you can override:

Assets

Replace specific assets without affecting the parent version or other variants:

  • Swap images (e.g., different backgrounds per network)
  • Change audio files (e.g., localized voiceovers)
  • Update data files (e.g., different game configurations)

Parameters

Adjust game parameters for the target network or audience:

  • Text and labels (localization, CTA copy)
  • Colors and themes
  • Gameplay settings (difficulty, timing)
  • UI layout adjustments

Variants also support localization inheritance — translations from the parent version are automatically available, and you can override specific translations per variant as needed.

Network Settings

Configure network-specific export options:

  • Orientation (portrait, landscape, responsive)
  • File size optimization targets
  • Click-through URL and tracking parameters

Overrides and Inheritance

Variants follow a hierarchical override model:

Organization defaults
 └── Game settings
      └── Version configuration
           └── Variant overrides (highest priority)
  • Values not overridden in the variant are inherited from the parent version
  • Overridden values are marked with an indicator in the UI
  • You can reset any override to restore the inherited value

Tip: Only override what needs to change. This keeps variants maintainable and makes it easy to update the parent version.

A/B Testing with Variants

Variants are ideal for running A/B tests across ad networks:

  1. Create a base version with your core playable ad
  2. Create Variant A with the control experience
  3. Create Variant B with the test variation (e.g., different CTA, color scheme, or gameplay tweak)
  4. Export both variants for the same network
  5. Deploy each variant to a separate ad set in your network dashboard

Tips for A/B Testing

  • Change one variable at a time — Isolate the effect of each change
  • Use clear namingMeta - CTA Blue vs. Meta - CTA Red
  • Document hypotheses — Use the description field to record what you are testing

Managing Variants

Quick Actions

From the variant list, you can:

  • Customize — Open the customization panel to edit parameters and preview changes
  • Share — Generate a preview URL to share with team members or stakeholders
  • Edit Settings — Change the variant name, description, or status

Duplicating a Variant

To create a copy of an existing variant:

  1. Open the variant menu (three dots)
  2. Select Duplicate
  3. Enter a new name and adjust settings

Deleting a Variant

  1. Open the variant menu
  2. Select Delete
  3. Confirm the deletion

Note: Deleting a variant removes its overrides and exports but does not affect the parent version or other variants.

Next Steps

On this page