Features

• add trackScreenView and trackScreenLeave public APIs (#265)

Full Changelog

Features

• add trackScreenView and trackScreenLeave public APIs (#265)

Full Changelog

Features

• Added support to return the fallback reason for the feature flag varient, bumped native iOS and Android SDK versions to latest. (#267)

Full Changelog

Features

• Added support to return the fallback reason for the feature flag varient, bumped native iOS and Android SDK versions to latest. (#267)

Full Changelog

Chores

• Add prefetchFlags Option (#259)

Full Changelog

Chores

• Add prefetchFlags Option (#259)

Full Changelog

Features

• Added Swift Package Manager (SPM) support (#235)

Full Changelog

Features

• Add Swift Package Manager (SPM) support (#235)

Full Changelog

Features

• wire mixpanel_flutter to MixpanelEventBridge (#249)
• Add serverURL option for Mixpanel init (#247)
• expose serverURL in Mixpanel.init() (#245)

Full Changelog

Features

• wire mixpanel_flutter to MixpanelEventBridge (#249)
• Add serverURL option for Mixpanel init (#247)
• expose serverURL in Mixpanel.init() (#245)

Full Changelog

v2.8.0 (2026-05-08)

Enhancements

• Feature Flag Persistence #236

Enhancements

• Feature Flag Persistence #236

Enhancements

• Add getAllVariants support for Feature Flags #233

Enhancements

• Update Mixpanel Swift SDK to 6.3.0

Fixes

• Feature Flags proper track() and getVariant() sequential ordering (within Swift SDK)

Enhancements

• Update Mixpanel Android SDK to 8.5.1

Fixes

• Feature Flags will auto load on inititialization (within Android SDK)
• Feature Flags first time event track fix (within Android SDK)
• Feature Flags proper track() and getVariant() sequential ordering (within Android SDK)

Enhancements

• Add OSX desktop support #220
• Update Mixpanel Android SDK to 8.5.0
• Update Mixpanel Swift SDK to 6.2.0
• updateContext() now calls setContext on iOS and Android instead of being a no-op #210
• loadFlags() now supported on web via mixpanel.flags.load_flags() #210
• Refactor Mixpanel instance management in iOS Flutter plugin #221

Enhancements

• Feature Flags Support #209

Fixes

• Ensure complex / dynamic values are properly serializable on web #197

Fixes

• Move Mixpanel Android Method Channel Initialization back to onAttachedToEngine #196

Enhancements

• Bump native libraries to Swift 5.1.0 and Android 8.2.0 #194

Fixes

• fix: .jsify() error polluting console logs #193
• Defer MixpanelFlutterPlugin registration and initialization to prevent ANRs #191

Fixes

• Bump mixpanel-swift version to 5.0.0 #187

Enhancements

• Bump to Swift 4.4.0 and Android 8.0.3 #183
• Refactor: Improve type safety in MixpanelFlutterHelper & Remove Plug… #181
• feat: Add wasm support #167

Fixes

• Remove unused PluginRegistry dependency #182

Fixes

• revert minsdk #166
• revert android #165

Enhancements

• upgrade iOS SDK to 4.3.0 #162
• Upgrade minSDK to 23 #161
• Fix: Resolve compilation issues in SDK and main.dart #160
• Lower js constraint to allow 0.6.x #142

Enhancements

• bump iOS to 4.2.5 and Android to 7.5.0 #141

Enhancements

• Update AGP to 8 and update all dependencies #139
• upgrade js to 0.7.1 #138
• Add Future return in some methods #136

Enhancements

• add api: setFlushBatchSize #102

  /// Set the number of events sent in a single network request to the Mixpanel server.
  /// By configuring this value, you can optimize network usage and manage the frequency of communication between the client
  /// and the server. The maximum size is 50; any value over 50 will default to 50.
  /// * [flushBatchSize] an int representing the number of events sent in a single network request.
  void setFlushBatchSize(int flushBatchSize) {
    _channel.invokeMethod<void>('setFlushBatchSize',
        <String, dynamic>{'flushBatchSize': flushBatchSize});
  }

• bump iOS to 4.2.0

Enhancements

• bump iOS version to 4.1.0 #102

NOTE:

• From this version we will prefix randomly generated device-specific distinct_ids with "$device:". The prefix is applied the next time a new random ID is generated, any IDs generated by previous SDK versions and persisted on the device will continue to be used as-is until reset is called to generate a new ID. This does not change the value sent for the $device_id property, which will continue to be the randomly-generated ID without a prefix. Mixpanel's $identify endpoint has been updated to accept UUIDs with this prefix to coordinate with this change.

Enhancements

• bump ios to 4.0.5 and android to 7.3.0 #99

BREAKING CHANGE:

This major release removes all remaining calls to Mixpanel's /decide API endpoint. The main effect of this is that the SDK no longer fetches the remote status of your project's "Automatically collect common mobile events" setting. From this version forward, automatic event tracking can only be controlled by the, now required, parameter trackAutomaticEvents. Upon upgrading, existing implementations will need to add this parameter to their Mixpanel initializer calls.

import 'package:mixpanel_flutter/mixpanel_flutter.dart';

class MixpanelManager {
  static Mixpanel? _instance;

  static Future<Mixpanel> init() async {
    if (_instance == null) {
      _instance = await Mixpanel.init("YOUR_PROJECT_TOKEN", trackAutomaticEvents: true);
    }
    return _instance!;
  }
}

Enhancements

• add param 'trackAutomaticEvents' to 'init' #86

Enhancements

• bump versions to get millisecond precision for event time property #82

Enhancements

• bump versions to remove survey #79

Enhancements

• add config for web init and setServerURL for web #75
• feat: support DateTime and Uri #66
• fix: Make flush method asynchronous #64

Enhancements

• bump iOS SDK version to 3.1.7 and Android to 6.1.1 #69

Fixes

• Registering non-string super props in init fails #51

Enhancements

• bump iOS SDK version to 3.1.4 #61

Fixes

• Fix registering non-string super props in init fails #62
• Fix several misspellings of "Mixpanel" #60
• Fix backward ordering of 'alias()' parameters on Android. #58

Fixes

• Bump iOS SDK depedency to v3.1.2 #52

Merged pull requests:

• bump Mixpanel native SDK version to iOS 3.0.0, Android 6.0.0 #46
• register super properties on Mixpanel.init for iOS #46
• fix nested dictionary not being able to tracked properly in iOS #43

Merged pull requests:

• Some lint fixes #40

Enhancements

• Add web support #35 Please add the following snippet to your web/index.html inside <head></head> in your Flutter project.

<script src="./assets/packages/mixpanel_flutter/assets/mixpanel.js"></script>

Enhancements

• Migrate from JCenter #22

Merged pull requests:

• Bump native SDK dependencies #29

Enhancements

• change the name 'properties' to 'superProperties' in init #28
• Add superProperties on initialize #14

Merged pull requests:

• Remove jCenter #24

Fixes

• Fix the bool value being tracked as Int #21

Enhancements

• Add API setUseIpAddressForGeolocation #18

• Add support for Null Safety! Thanks @incendial for contributing a PR for this. 🙏

• Improve docs

• 🚀 This is our first release! 🎉🎉🎉 Report issues or give us any feedback is appreciated!
• integration guide
• full API reference