On this page

Open Source Script

Use the open-source Statsig migration scripts to move feature flags, experiments, and metrics from third-party platforms into your Statsig project.

This package is designed to help automate migration of feature flags from LaunchDarkly to Statsig. It fetches feature flags from LaunchDarkly, translates them into Statsig's format, and creates corresponding feature gates in Statsig.

Considerations

This script works by default. Start with a test environment of 5–10 flags. Before running the script at scale, consider the following:

  • IMPORTANT: If you don't need to customize the import script, use Statsig's in-console tool instead.

  • The script uses a tag Imported from LaunchDarkly to identify migrated flags in Statsig. Ensure this tag is unique and recognizable.

  • The script includes a function to delete all Statsig feature gates with a specific tag. Use this with caution to clean up after a test or failed migration.

  • The script requires API keys for both LaunchDarkly and Statsig. Keep these keys secure.

Installation

To run the script, you need Node.js and npm installed on your system. Execute directly:

bash
npx @statsig/migrations --from launchdarkly --launchdarkly-project-id default <more-arguments>

Configuration

  • Provide your LaunchDarkly API key and Statsig Console API key in the script
  • Map LaunchDarkly environments to Statsig environments that aren't already the same by using --environment-name-mapping to the script.
  • Map LaunchDarkly context kind to Statsig's custom unit ids and custom fields.
You can find the detailed instructions for these steps on the Github repo.

Running the script

To execute the migration script, run the following command in your terminal:

bash
node index.js

The script performs the following actions:

  1. Fetch all feature flags from LaunchDarkly.
  2. Translate each flag into Statsig's format.
  3. Create feature gates in Statsig.
  4. Write the migration status and details to a CSV file named flag_migration_tracker.csv.

Example translations

The following examples show how LaunchDarkly feature flags are translated into Statsig feature gates:

Example 1: LaunchDarkly flag with email and name targeting conditions

Example 1 - LaunchDarkly to Statsig translation

Example 2: LaunchDarkly flag with country-based targeting (off flag)

Example 2 - LaunchDarkly to Statsig translation

Troubleshooting

If you encounter issues during the migration, check the following:

  • Confirm that the API keys are correct and have the necessary permissions.
  • Review the error messages in the console to diagnose the problem.

Pull requests and feedback are welcome.

Was this helpful?