Upgrading the Javascript library

If you integrated Mixpanel before December 3, 2012, you have an old version of the tracking library. You can tell for sure by checking the file name in the Mixpanel snippet; if it is not mixpanel-2.2.min.js or mixpanel-2-latest.min.js, you may have an older version of the library.

If you are using library version 2.1 (mixpanel-2.1.min.js) and you're sending People data, upgrading will cause some data inconsistency. Please email support@mixpanel.com before upgrading and have them review your implementation.

With all of that said, if you really want to upgrade, here's how:

  1. Change the embedded snippet to the one located here (don't forget to change the token, though).
  2. Update all mixpanel.people.identify("YOUR_USER_ID") calls to mixpanel.identify("YOUR_USER_ID").
  3. Add a single call to mixpanel.alias("YOUR_USER_ID") on your signup confirmation page (making sure to use the same ID scheme as you did previously).

Please make sure you're only calling mixpanel.alias() in one place, and only for new users.

Changes in tracking behavior

Most of the changes introduced by the new library are backwards compatible, but there are a few behavior changes you should be aware of:

  • mixpanel.people.identify() has been removed in favor of a unified mixpanel.identify() call
  • mixpanel.identify() now flushes queued People requests