For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/feature_flags/guide/migrate_flags_with_cli.md. A documentation index is available at /llms.txt.

Migrate Flags with the Flag Migration CLI

This product is not supported for your selected Datadog site. ().

Overview

The Datadog Flag Migration CLI is a command-line tool that helps you migrate feature flags from other providers to Datadog Feature Flags. The CLI reads flag definitions from a source provider and recreates them in Datadog, preserving targeting rules, variations, and rollout configurations where possible.

If you migrate flags from Eppo, they keep Eppo-compatible bucketing. Existing subjects continue to receive the same variants after you switch flag evaluation to Datadog.

Prerequisites

Before running the CLI, make sure your Datadog organization is set up:

  • Users and Teams: Your Datadog organization should be provisioned with the users and teams needed to manage flags. The CLI does not create users or teams for you.
  • Feature Flag Environments: The feature flag environments you plan to migrate into should be created before running the CLI. The CLI does not create environments for you.

For details on how the migration works and the providers it supports, see the GitHub repository.

Run the CLI

Run the migration with npx:

npx @datadog/dd-flag-migration migrate

For full configuration options, supported source providers, authentication setup, and troubleshooting, see the dd-flag-migration README on GitHub.

Further reading