Feature Flag Migration Playbook by mintlify[bot] · Pull Request #95 · mixpanel/docs

mintlify · 2026-07-14T14:24:56Z

Summary

This update introduces a new guide for migrating feature flags and experiments from other platforms to Mixpanel. It outlines a five-part process to ensure a smooth transition, covering exposure events, configurations, and verification.

Changes

Added guides/strategic-playbooks/feature-flag-migration-playbook.mdx.
Included new images: images/FeatureFlagSetup.png, images/ExperimentSetup.png, and images/ExperimentSetupMetrics.png.
Integrated the new playbook into the docs.json navigation structure.

Mintlify

0 threads from 0 users in Mintlify

No unresolved comments

- Updated docs/what-is-mixpanel.mdx - Created images/FeatureFlagSetup.png - Created images/ExperimentSetup.png - Created images/ExperimentSetupMetrics.png - Created guides/strategic-playbooks/feature-flag-migration-playbook.mdx - Updated docs.json Mintlify-Source: dashboard-editor

kurbycchua

Overall comment is we need to make sure we fact check these as we do not want a customer ending up in messing up their experiment / FF data in mixpanel. Migrating the exposure of $experiment_started I find it the easy part, the challenging part is the Experiment report and the FF report of which underlying drives the analysis and the gates

- Updated docs/what-is-mixpanel.mdx - Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

kurbycchua · 2026-07-17T03:37:05Z

                      "guides/strategic-playbooks/onboarding-playbook/beyond-onboarding"
                    ]
                  },
+                  "guides/strategic-playbooks/feature-flag-migration-playbook",


@amymadden-bit more of a nitpick on this... depending on how we want to position this the actual content has a title of "Migrating Your Feature Flags and Experiments to Mixpanel" but the menu says "Feature Flag Migration Playbook" Also since the content is also covering feature flag that are NOT related to experiments - that's another angle to consider.

@kurbycchua fair point, it's a bit long but I updated to "Feature Flag & Experiments Migration Playbook" (I think.... I did it in mintlify so hopefully it pulled over)

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

kurbycchua · 2026-07-20T08:35:39Z

+
+## Step 1. Migrate past experiment exposure events
+
+An exposure event records that a user was enrolled in an experiment, and was bucketed into an experiment variant. To keep your historical data, export your existing exposure events from your current vendor and ingest them to Mixpanel as `$experiment_started` events. 


@xinlintanmp @amymadden-bit nitpick: This statement "An exposure event records that a user was enrolled in an experiment, and was bucketed into an experiment variant." might imply to readers that exposure events (ie feature gate, dynamic config) not related to experiments need not be migrated.

kurbycchua · 2026-07-20T09:31:40Z

+	"properties": {
+		"distinct_id": "alice@example.com", // enrollment ID
+		"time": 1709275888, // Timestamp
+		"$insert_id": "exp_4821_alice_1709275888",


@xinlintanmp maybe a comment like //prevent re-run duplicates

kurbycchua · 2026-07-20T09:39:56Z

+  "status": "enabled",
+  "data_group_id": null,
+  "serving_method": "client",
+  "experiment_id": 12345,


@xinlintanmp @amymadden-bit We didn't really explain these? My guess is they should be tied to the id returned when creating the experiment? This is why I think it's important to have an engineer review these examples?

experiment_id

is_experiment_active

kurbycchua

See additional comments, I have resolved those that were updated. This is a more detailed read from me and I literally took a longer time trying to push my shoes into someone who is reading this for the first time and trying to figure out how to migrate. It's a good start but I feel it needs more meet to be a playbook

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

greptile-apps · 2026-07-21T02:48:15Z

Confidence Score: 5/5

No additional blocking issue qualifies for this follow-up review.

No distinct incomplete or unsafe fix was found in the reviewed changes.
No separate production breakage remained after applying the required follow-up scope.

Important Files Changed

Filename	Overview
guides/strategic-playbooks/feature-flag-migration-playbook.mdx	Adds the feature flag and experiment migration guide.
docs.json	Adds the migration playbook to the strategic playbooks navigation.
docs/what-is-mixpanel.mdx	Updates the Next Steps section on the Mixpanel introduction page.

_{Reviews (5): Last reviewed commit: "Merge branch 'main' into amymadden-ffmig..." | Re-trigger Greptile}

greptile-apps · 2026-07-21T02:48:20Z

+
+In the case of live experiments, migration will result in users getting reassigned to a different variant mid-experiment. We recommend completing any existing experiments and importing the historical exposure events into Mixpanel, then launching the equivalent experiment fresh in Mixpanel post-cutover.
+
+1. **If your code uses OpenFeature**: Swap the provider — replace your current provider with the Mixpanel provider and leave your existing evaluation calls unchanged, as long as your flag keys carried over identically.


Provider Swap Changes Evaluation Context

Identical keys are not enough to keep existing OpenFeature calls unchanged. Mixpanel does not treat targetingKey as a special bucketing key, and its web provider does not support per-evaluation context, so applications relying on either behavior can target or bucket users incorrectly after the swap.

@xinlintanmp @russell-loube-mixpanel anyway to validate what AI said above

greptile-apps · 2026-07-21T02:48:22Z

 Now that you understand the basics, **we recommend planning the first events you would like to track**. This will help you understand what you need to get started. Choosing these events should take no more than 5 minutes.

-<ExtendedButton title="Plan Your Tracked Events" link="/docs/what-to-track" />
-
 #### Already Know What You Want to Track?

-If you already know the events you want to track, you can skip planning and start by installing Mixpanel.
-
-<ExtendedButton title="Install Mixpanel" link="/docs/quickstart/install-mixpanel" />
+If you already know the events you want to track, you can skip planning and start by installing Mixpanel.


Next Steps Lose Their Links

The updated page still tells readers to plan events or install Mixpanel, but both destination buttons were removed. The onboarding page now ends without a way to perform either recommended next step.

Suggested change

Now that you understand the basics, **we recommend planning the first events you would like to track**. This will help you understand what you need to get started. Choosing these events should take no more than 5 minutes.

<ExtendedButton title="Plan Your Tracked Events" link="/docs/what-to-track" />

#### Already Know What You Want to Track?

If you already know the events you want to track, you can skip planning and start by installing Mixpanel.

<ExtendedButton title="Install Mixpanel" link="/docs/quickstart/install-mixpanel" />

If you already know the events you want to track, you can skip planning and start by installing Mixpanel.

Now that you understand the basics, **we recommend planning the first events you would like to track**. This will help you understand what you need to get started. Choosing these events should take no more than 5 minutes.

<ExtendedButton title="Plan Your Tracked Events" link="/docs/what-to-track" />

#### Already Know What You Want to Track?

If you already know the events you want to track, you can skip planning and start by installing Mixpanel.

<ExtendedButton title="Install Mixpanel" link="/docs/quickstart/install-mixpanel" />

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx - Created images/Screenshot-2026-07-21-at-4.36.21-PM.png Mintlify-Source: dashboard-editor

kurbycchua

Resolved a couple of comments and kept those that seems unresolved open, @xinlintanmp once you edit something do you mind replying in the comment so I'd know which one you already accounted for?

kurbycchua

@russell-loube-mixpanel tagged you in 2 comments

mintlify Bot requested review from a team as code owners July 14, 2026 14:24

mintlify Bot requested review from caracheng and hywel-mixpanel July 14, 2026 14:24

mintlify Bot deployed to staging July 14, 2026 14:27 View deployment

hywel-mixpanel requested changes Jul 14, 2026

View reviewed changes

Comment thread docs/what-is-mixpanel.mdx

re-add buttons

5dad299

mintlify Bot deployed to staging July 14, 2026 19:26 View deployment

hywel-mixpanel approved these changes Jul 14, 2026

View reviewed changes

kurbycchua reviewed Jul 15, 2026

View reviewed changes

Merge branch 'main' into amymadden-ffmigration

e80d6d6

mintlify Bot deployed to staging July 15, 2026 06:53 View deployment

mintlify Bot added 2 commits July 16, 2026 10:04

Updated mintlify pages

35431c1

- Updated docs/what-is-mixpanel.mdx - Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

Updated mintlify pages

63856b9

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 16, 2026 10:06 View deployment

mintlify Bot deployed to staging July 16, 2026 10:07 View deployment

Updated mintlify pages

f9595ef

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 17, 2026 02:17 View deployment

kurbycchua reviewed Jul 17, 2026

View reviewed changes

Comment thread guides/strategic-playbooks/feature-flag-migration-playbook.mdx Outdated

xinlintanmp added 2 commits July 17, 2026 16:36

Updated mintlify pages

f07f10a

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

Updated mintlify pages

6026ebe

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 17, 2026 08:38 View deployment

mintlify Bot deployed to staging July 17, 2026 08:40 View deployment

Updated mintlify pages

53c3d34

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 17, 2026 08:42 View deployment

Updated mintlify pages

34018de

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 17, 2026 14:59 View deployment

kurbycchua reviewed Jul 20, 2026

View reviewed changes

Comment thread guides/strategic-playbooks/feature-flag-migration-playbook.mdx Outdated

kurbycchua reviewed Jul 20, 2026

View reviewed changes

Comment thread guides/strategic-playbooks/feature-flag-migration-playbook.mdx Outdated

kurbycchua reviewed Jul 20, 2026

View reviewed changes

Comment thread guides/strategic-playbooks/feature-flag-migration-playbook.mdx

kurbycchua reviewed Jul 20, 2026

View reviewed changes

Merge branch 'main' into amymadden-ffmigration

b9feae0

mintlify Bot deployed to staging July 20, 2026 09:57 View deployment

xinlintanmp added 2 commits July 21, 2026 10:42

Updated mintlify pages

aa59d79

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

Updated mintlify pages

5a7dfe3

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 21, 2026 02:43 View deployment

Updated mintlify pages

f1779d7

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 21, 2026 02:45 View deployment

Updated mintlify pages

e4067e6

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 21, 2026 02:46 View deployment

mintlify Bot deployed to staging July 21, 2026 02:48 View deployment

greptile-apps Bot reviewed Jul 21, 2026

View reviewed changes

xinlintanmp added 2 commits July 21, 2026 11:12

Updated mintlify pages

cce4eb7

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

Updated mintlify pages

1e5b4b7

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 21, 2026 03:14 View deployment

mintlify Bot deployed to staging July 21, 2026 03:15 View deployment

Updated mintlify pages

1d44f6b

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 21, 2026 08:26 View deployment

Updated mintlify pages

47a7e56

- Updated guides/strategic-playbooks/feature-flag-migration-playbook.mdx - Created images/Screenshot-2026-07-21-at-4.36.21-PM.png Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging July 21, 2026 08:38 View deployment

kurbycchua requested changes Jul 21, 2026

View reviewed changes

Merge branch 'main' into amymadden-ffmigration

269c307

kurbycchua reviewed Jul 21, 2026

View reviewed changes

mintlify Bot deployed to staging July 21, 2026 10:07 View deployment


		## Step 1. Migrate past experiment exposure events

		An exposure event records that a user was enrolled in an experiment, and was bucketed into an experiment variant. To keep your historical data, export your existing exposure events from your current vendor and ingest them to Mixpanel as `$experiment_started` events.


		In the case of live experiments, migration will result in users getting reassigned to a different variant mid-experiment. We recommend completing any existing experiments and importing the historical exposure events into Mixpanel, then launching the equivalent experiment fresh in Mixpanel post-cutover.

		1. If your code uses OpenFeature: Swap the provider — replace your current provider with the Mixpanel provider and leave your existing evaluation calls unchanged, as long as your flag keys carried over identically.

Uh oh!

Conversation

mintlify Bot commented Jul 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Mintlify

Uh oh!

Uh oh!

kurbycchua left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kurbycchua Jul 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

amymadden-bit Jul 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

kurbycchua Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

kurbycchua Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

kurbycchua Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

kurbycchua left a comment

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Confidence Score: 5/5

Important Files Changed

Uh oh!

Uh oh!

Uh oh!

greptile-apps Bot Jul 21, 2026

Choose a reason for hiding this comment

Uh oh!

kurbycchua Jul 21, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

greptile-apps Bot Jul 21, 2026

Choose a reason for hiding this comment

Uh oh!

kurbycchua left a comment

Choose a reason for hiding this comment

Uh oh!

kurbycchua left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

mintlify Bot commented Jul 14, 2026 •

edited

Loading

kurbycchua Jul 17, 2026 •

edited

Loading

greptile-apps Bot commented Jul 21, 2026 •

edited

Loading