Encatch
Welcome to Encatch Docs
SettingsGlobal Settings

Experiments

Configure A/B/N rollout with variants and percentile ranges

Experiments let you define A/B/N rollout groups for your project. Each experiment has variants with named percentile ranges so you can control how users are bucketed—for example a control group and one or more test groups.

Where to find it

  1. Open your project in the encatch dashboard.
  2. Go to Settings.
  3. Under Global Settings, open Experiments.

If you do not see Experiments, contact your organization administrator—you may need additional access.

Page description: Configure A/B/N rollout. Define variants with named percentile ranges to control feature rollouts.

Experiments list

The left panel shows all experiments in the project and how many exist. Select an experiment to edit it on the right, or create a new one.

  • New Experiment / Create Experiment — Opens the create dialog (subject to your plan’s experiment limit).
  • If the list is empty, you see No experiments yet with a prompt to create your first experiment for A/B/N rollouts.
  • When nothing is selected on the right, the page prompts you to Select an experiment from the list or create your first experiment.

Each list item shows the experiment name and slug.

If you reach your plan’s experiment limit, you will see Experiments limit reached and need to upgrade before creating more.

Create an experiment

  1. Click New Experiment or Create Experiment.
  2. In the Create Experiment dialog, fill in:
    • Slug (required) — Lowercase letters, numbers, and underscores only. Cannot be changed after creation.
    • Name (optional) — Display name.
    • Description (optional).
  3. Click Create.

You are taken to the experiment detail view to configure variants and ranges.

Experiment details

After selecting an experiment, the Experiment Details panel includes:

FieldDescription
SlugRead-only system identifier.
NameEditable display name.
DescriptionOptional notes about the experiment.

Click Save to apply changes to name, description, and variants.

Use the menu for:

  • Details — View name, description, variant summary, created/updated timestamps, and who created or last updated the experiment.
  • Delete experiment — Permanently remove the experiment (cannot be undone).

Experiment master reference

If the experiment is in use as an active master reference, you may see a notice that editing this document does not automatically change live feedback—you need to update the experiment in Advanced Options on the relevant form for changes to take effect there.

Variants and ranges

Under Variants & Ranges, define how users are split (up to 10 variants per experiment).

  1. Click Add Variant to add a variant group.
  2. For each variant, set:
    • Variant name — e.g. Default, Variant A.
    • Ranges — One or more named slices with start and end percentages (0–100).

Use Add Range inside a variant to add another range row. Each range has a name (e.g. Control, Test) and a percent band such as 050 and 50100.

Ranges within a variant must:

  • Start at 0% for the first range.
  • Be contiguous (no gaps or overlaps between ranges).
  • Have start less than end, and end not above 100%.
  • Cover up to 100% total (partial coverage such as 0–50% only is allowed).

If validation fails, an error message appears before you can save—for example missing ranges, overlapping bands, or end above 100%.

Use Remove variant or the trash icon on a range row to delete items you no longer need.

Typical workflow

  1. Create an experiment with a stable slug.
  2. Add variants and percentile ranges that match your rollout design.
  3. Save the experiment.
  4. Attach the experiment in feedback Advanced Options where you want A/B/N behavior (update there when you change variant definitions used in production).

Best practices

  • Use clear slugs (e.g. checkout_rollout_v1) and do not change them after the experiment is referenced elsewhere.
  • Keep range names meaningful (Control, Treatment A) so reports and targeting are easy to understand.
  • Start with two variants and two contiguous ranges (e.g. 0–50% and 50–100%) for a simple A/B split.

Was this page helpful?