Overview
This guide covers using Mixpanel’s Feature Flags through the OpenFeature standard with the Mixpanel Node.js OpenFeature provider. OpenFeature provides a vendor-agnostic API for feature flag evaluation, allowing you to switch between providers without changing your application code. For the native Mixpanel SDK approach, see the Feature Flags (Node.js) guide.Prerequisites
- Enterprise subscription plan with Feature Flags enabled
- Node.js 10 or higher
- Project Token from your Mixpanel Project Settings
Installation
Quick Start
Initialization
Local Evaluation (Recommended)
Remote Evaluation
Using an Existing Mixpanel Instance
Usage
Flag Types and Evaluation Methods
Evaluation Context
Unlike some providers,
targetingKey is not used as a special bucketing key. It is passed as another context property. Mixpanel’s server-side configuration determines which properties are used for targeting and bucketing.Full Resolution Details
Accessing the Underlying Mixpanel Instance
Shutdown
Error Handling
Troubleshooting
Flags Always Return Default Values
- Provider not ready: Use
setProviderAndWait()to ensure flags are ready before evaluation. - Invalid project token: Verify the token matches your Mixpanel project.
- Flag not configured: Verify the flag exists and is enabled.
Type Mismatch Errors
Verify the flag’s value type matches your evaluation method. UsegetObjectValue() for JSON objects.