> ## Documentation Index
> Fetch the complete documentation index at: https://confidence.spotify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate from Statsig to Confidence

> Learn how to migrate feature gates, dynamic configs, and experiments from Statsig to Confidence with the AI-powered migration kit.

export const HowToSchema = ({name, description, steps = []}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "HowTo",
    name,
    description
  };
  if (steps.length > 0) {
    schema.step = steps.map((s, i) => ({
      "@type": "HowToStep",
      position: i + 1,
      name: typeof s === "string" ? s : s.name,
      text: typeof s === "string" ? s : s.text || s.name
    }));
  }
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

<HowToSchema
  name="Migrate from Statsig to Confidence"
  description="Migrate feature gates, dynamic configs, and experiments from Statsig to Confidence with the AI-powered migration kit."
  steps={[
{
  name: "Plan the flag migration",
  text: "Run /confidence:migrate-statsig plan flag. The kit scans your Statsig gates, dynamic configs, and experiments and writes a migration plan file.",
},
{
  name: "Review the plan",
  text: "The plan lists every flag with its targeting rules and rollout percentages, and marks anything that can't migrate automatically.",
},
{
  name: "Execute the flag migration",
  text: "Run /confidence:migrate-statsig execute with the plan file. The kit recreates your gates, configs, and experiments in Confidence with matching rules and variant splits.",
},
{
  name: "Plan and execute the code migration",
  text: "Run /confidence:migrate-statsig plan code, review the plan, then execute it. The kit rewrites your Statsig SDK call sites to OpenFeature with the Confidence SDK, creating one pull request per flag.",
},
]}
/>

Run this skill to migrate from Statsig to Confidence:

```bash theme={null}
npx skills add spotify/confidence-ai-plugins --skill migrate-statsig
```

The installer works with Claude Code, Cursor, Codex, Gemini CLI, and other AI assistants, and asks which one to install to. You can also install the full [Confidence plugin](/docs/migrations/overview#install-the-confidence-plugin) with your assistant's own plugin manager.

The kit moves your feature gates, dynamic configs, and experiments to Confidence, then rewrites your application code from the Statsig SDK to the Confidence SDK. See the [migrations overview](/docs/migrations/overview) for how migration kits work.

## Before You Begin

To run this migration kit, you need:

* The [Confidence plugin](/docs/migrations/overview#install-the-confidence-plugin) installed in your AI assistant
* A Statsig Console API key (starts with `console-`) with read access to gates, dynamic configs, and experiments, stored in the `STATSIG_API_KEY` environment variable. You can create one under **Project Settings > API Keys** in the Statsig console.
* The Confidence Flags MCP server, authenticated with your account
* The Confidence Documentation MCP server, used during code transformation
* Optional: a Confidence REST API token stored in the `CONFIDENCE_TOKEN` environment variable, required for partial experiment allocation, reusable segments, layer mutual exclusion, and holdouts

## Run the Migration

Invoke the kit with the `/confidence:migrate-statsig` command in your AI assistant.

<Steps>
  <Step title="Plan the flag migration">
    Run `/confidence:migrate-statsig plan flag`. The kit scans your Statsig gates, dynamic configs, and experiments and writes a migration plan file.
  </Step>

  <Step title="Review the plan">
    The plan lists every flag with its targeting rules and rollout percentages, and marks anything that can't migrate automatically. Plan files are resumable, so you can pause and continue later.
  </Step>

  <Step title="Execute the flag migration">
    Run `/confidence:migrate-statsig execute <plan-file>`. The kit recreates your gates, configs, and experiments in Confidence with matching rules and variant splits.
  </Step>

  <Step title="Plan and execute the code migration">
    Run `/confidence:migrate-statsig plan code`, review the plan, then execute it. The kit rewrites your Statsig SDK call sites to OpenFeature with the Confidence SDK, creating one pull request per flag.
  </Step>
</Steps>

## What Gets Migrated

| Statsig            | Confidence                                                               |
| ------------------ | ------------------------------------------------------------------------ |
| Feature gate       | Boolean flag with `enabled`/`disabled` variants                          |
| Dynamic config     | Struct flag where each rule's return value becomes a variant             |
| Experiment         | Struct flag where each group becomes a variant with its percentage split |
| Segment            | Segment, or conditions copied into targeting rules                       |
| Layer              | Mutual-exclusion group (requires the REST API token)                     |
| Rollout percentage | Rollout percentage on the targeting rule                                 |

## Known Limitations

The kit flags these Statsig features for manual review because Confidence doesn't support them:

* Substring conditions (`str_contains_any`, `str_contains_none`) and general regular expression matching
* Conditions that depend on another experiment's assignment (`experiment_group`)
* Custom JavaScript conditions
* Custom event logging (`logEvent`)—Confidence doesn't expose a matching API
* Large ID list segments and analysis-only segments without the REST backend

## Analyze Historical Experiments

The migration kit moves your flags and code, not your historical experiment results. To re-analyze experiments that ran on Statsig, import their assignment data into your data warehouse and follow the [Analyze a Past Experiment](/docs/quickstarts/analyze-past-experiment) quickstart.

## Related Resources

<CardGroup cols={2}>
  <Card title="Migrations Overview" href="/docs/migrations/overview">
    How migration kits work and how to install the plugin
  </Card>

  <Card title="Use AI with Confidence" href="/docs/quickstarts/use-mcp">
    Set up the Confidence MCP servers for your AI assistant
  </Card>

  <Card title="Analyze a Past Experiment" href="/docs/quickstarts/analyze-past-experiment">
    Re-analyze experiments that ran on another platform
  </Card>

  <Card title="SDK Integration" href="/docs/sdks/introduction">
    Integrate Confidence SDKs into your application
  </Card>
</CardGroup>
