For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • Get started
    • Overview
    • Onboarding
    • Get started
    • Launch Insights
    • LaunchDarkly architecture
    • LaunchDarkly vocabulary
  • AgentControl
    • AgentControl
    • Manage AgentControl
  • Feature flags
    • Create flags
    • Target with flags
    • Flag templates
    • Manage flags
    • Code references
    • Contexts
    • Segments
  • Releases
    • Releasing features with LaunchDarkly
    • Release policies
    • Percentage rollouts
    • Progressive rollouts
    • Guarded rollouts
    • Feature monitoring
    • Release pipelines
    • Engineering insights
    • Release management tools
    • Applications and app versions
    • Change history
    • Restoring previous flag versions
  • Observability
    • Observability
    • Session replay
    • Error monitoring
    • Logs
    • Traces
    • Observability metrics
    • Product analytics events
    • LLM observability
    • Alerts
    • Dashboards
    • Service map
    • Vega for auto-remediation
    • Observability MCP server
    • Search specification
    • Observability settings
    • Observability integrations
  • Experimentation
    • Experimentation
    • Experiment metric types
    • Experiment configuration
    • Managing experiments
    • Analyzing experiments
    • Multi-armed bandits
    • Holdouts
      • Creating holdouts
      • Managing holdouts
  • Metrics and events
    • Metrics in LaunchDarkly
    • Creating metrics
    • Metric groups
    • Events
    • Autogenerated metrics
  • Warehouse native
    • Warehouse native metrics
    • Setting up external warehouses
    • Creating experiments using warehouse native metrics
  • Infrastructure
    • Connect apps and services to LaunchDarkly
    • LaunchDarkly in China and Pakistan
    • LaunchDarkly in the European Union (EU)
    • LaunchDarkly in federal environments
    • Public IP list
  • Your account
    • Projects
    • Views
    • Environments
    • Tags
    • Teams
    • Members
    • Roles
    • Account security
    • Feature previews
    • Billing and usage
    • Changelog
Sign inTry it free
LogoLogo
On this page
  • Overview
  • About holdouts
  • Prerequisites
Experimentation

Holdouts

Was this page helpful?
Previous

Creating holdouts

Next
Built with

Overview

This topic introduces holdouts, which you can use to measure the effectiveness of your Experimentation program over time.

Holdouts are available for most SDKs

Holdout experiments are available with server-side and client-side SDKs, with the exception of Apex and Electron. If you use holdouts and are using a client-side SDK, your minimum SDK versions may differ from those listed on the Experimentation prerequisites page. To find the minimum required version for holdouts, read Supported features.

About holdouts

Holdouts let you exclude a percentage of your audience from all experiments over a set amount of time. This can help you understand how much of an impact your experiments have on certain metrics.

For example, you can hold back 5% of your user base from all of the experiments you run in a certain quarter. At the end of the quarter, you can compare the 95% that were included in experiments to the 5% that were excluded to find out which group spent more money overall, or which group signed up for services at a higher rate. If there are no measurable differences between the two groups you may want to reconsider the number, scope, and design of the experiments you’re running.

The Holdouts list.

The Holdouts list.
Holdouts and mutually exclusive experiments are different

Holdout experiments and mutually exclusive experiments are similar, but are used for different reasons. Holdout experiments withhold a set of end users from all experiments. Mutually exclusive experiments use layers to ensure end users are not included in two or more specific experiments at the same time. To learn more, read Mutually exclusive experiments.

Prerequisites

To use holdouts, you should understand the following concepts:

  • Experiment audiences
  • Randomization units
  • Analyzing experiment results by attribute

You also need an Admin or Owner base role, or a custom role with flag permissions, experiment permissions, and holdout permissions.

To learn how to create and manage holdouts, read Creating holdouts and Managing holdouts.

To learn how to build and run an example holdout, read Measuring Experimentation impact with holdouts.