> ## 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 Eppo to Confidence

> Learn how to migrate feature flags, allocations, and audiences from Eppo 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 Eppo to Confidence"
  description="Migrate feature flags, allocations, and audiences from Eppo to Confidence with the AI-powered migration kit."
  steps={[
{
  name: "Plan the flag migration",
  text: "Run /confidence:migrate-eppo plan flag. The kit scans your Eppo flags, asks you to choose a Confidence client and map the subject entity, and writes a migration plan file.",
},
{
  name: "Review the plan",
  text: "The plan lists every flag with its allocations and targeting rules, and marks anything that can't migrate automatically.",
},
{
  name: "Execute the flag migration",
  text: "Run /confidence:migrate-eppo execute with the plan file. The kit recreates your flags in Confidence with one targeting rule per allocation, in the same waterfall order.",
},
{
  name: "Plan and execute the code migration",
  text: "Run /confidence:migrate-eppo plan code, review the plan, then execute it. The kit rewrites each Eppo SDK call to the Confidence SDK, creating one pull request per flag.",
},
]}
/>

Run this skill to migrate from Eppo to Confidence:

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

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 flags, allocations, and audiences to Confidence, then rewrites your application code from the Eppo 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
* An Eppo API key—not an SDK key—with read access to feature flags, stored in the `EPPO_API_KEY` environment variable. You can create one under **Admin > API Keys** in the Eppo dashboard.
* The Confidence Flags MCP server, authenticated with your account
* The Confidence Documentation MCP server, used during code transformation

## Run the Migration

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

<Steps>
  <Step title="Plan the flag migration">
    Run `/confidence:migrate-eppo plan flag`. The kit scans your Eppo flags, asks you to choose a Confidence client and map the subject entity, and writes a migration plan file.
  </Step>

  <Step title="Review the plan">
    The plan lists every flag with its allocations and targeting rules, 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-eppo execute <plan-file>`. The kit recreates your flags in Confidence with one targeting rule per allocation, in the same waterfall order.
  </Step>

  <Step title="Plan and execute the code migration">
    Run `/confidence:migrate-eppo plan code`, review the plan, then execute it. If your app already uses OpenFeature, the kit swaps the registered provider and leaves call sites unchanged. Otherwise it rewrites each Eppo SDK call to the Confidence SDK, creating one pull request per flag.
  </Step>
</Steps>

## What Gets Migrated

| Eppo                            | Confidence                                                      |
| ------------------------------- | --------------------------------------------------------------- |
| Feature flag with allocations   | Flag with one targeting rule per allocation, in waterfall order |
| Reusable audience               | Segment, created once and referenced by multiple flags          |
| `subjectKey` randomization unit | Entity field of your choice, such as `user_id`                  |
| Default allocation              | Final catch-all targeting rule at 100%                          |
| Variation value                 | Variant assigned within a rule                                  |

<Note>
  Confidence has no server-side flag default. The kit reproduces Eppo defaults as a final catch-all targeting rule that serves the default variant.
</Note>

## Known Limitations

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

* Switchback allocations that rotate exposure in time windows
* General regular expression matching—only prefix, suffix, and alternation patterns convert cleanly
* Contextual bandits (`getBanditAction`), which need a redesign in Confidence

## Analyze Historical Experiments

The migration kit moves your flags and code, not your historical experiment results. To re-analyze experiments that ran on Eppo, 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>
