Feature flags

Environments

SDK keys and rollout behavior across development, staging and production.

Last updated: May 22, 20268-14 minBeginner to intermediate
Start free See pricingMethodology

Feature flags vs A/B tests

An A/B test measures the performance of experiences. A feature flag controls who receives a new feature, in which environment and at what rollout percentage. Testvoy connects these worlds so product and engineering teams can move between safe rollout and measured experimentation.

Development, staging and production environments

Staged rollout by percentage

Fast rollback with kill switch

Approval gates and audit trail

Environment-specific SDK keys

Flag rollout flow
DevStagingProd
Environment, rollout, approval and kill switch are managed in one operations surface.

Safe rollout checklist

A flag should not be treated as only an on/off switch. New features ship more safely when rollout plan, measurement goal, owner, rollback criteria and audit history are clear upfront.

  • Is the owner and approver clear?
  • Is the SDK key correct in staging?
  • Did rollout start with a small audience?
  • Was the kill switch tested?
  • Is a decision goal or health metric connected?

Example feature flag rollout

Example: you want to test a new checkout flow in staging and then expose it to a small slice of production traffic. Separate the flag by environment, keep kill switch ready and check health metric plus conversion goal before increasing rollout.

  1. 01

    Flag name: checkout_v2

  2. 02

    Enable 100% in development and staging

  3. 03

    Start production rollout at 5%

  4. 04

    Assign owner and approver

  5. 05

    Test kill switch

  6. 06

    Watch purchase_completed and error_rate

  7. 07

    If healthy, move to 25%, 50%, 100%

SDK flag check example
const enabled = window.testvoy?.flags?.isEnabled?.("checkout_v2");

if (enabled) {
  renderCheckoutV2();
} else {
  renderCheckoutV1();
}

Practical scenario

A growth team changes CTA copy on the pricing page, connects signup_started and signup_completed goals, then reads Google Ads and returning visitor segments separately. If the result is promising, they share a report link with the client or leadership.

Common mistakes

Most mistakes come from wrong project keys, overly broad selectors, missing goals, staging/prod mixups, early decisions on small samples or skipping mobile QA.

Naming an experiment 'test'

Launching without a goal

Deciding on total CVR only

Sending screenshots instead of shareable reports

Frequently asked questions

Who is Environments for?

Marketing, growth, product and developer teams can use the same guide at different depths.

Do I need a developer?

Not for basic visual changes and report reading; SDK, custom events, custom JS or enterprise security benefit from technical support.

How do I know it worked?

Verifier, recent events, preview, QA checklist and report warnings show setup and experiment health.

What is the common mistake?

Wrong project keys, missing goals, fragile selectors, early decisions on small samples and skipped mobile QA are common.

Docs

Try this guide in the app

Finish setup, create your first experiment and read the report with cleaner data in Testvoy.