If you ever need help, please email us at support@mixpanel.com
Back to topics

Special or reserved properties

Updated Nov. 17, 2014

Special properties for events

  • distinct_id
    A way to uniquely identify your users for things like funnels. You can set this to any value or use the Javascript call mpq.identify("Username here");
  • ip
    the ip address of the client. If distinct_id is not present, this will be used for uniqueness.
  • mp_name_tag
    This is used to give your users real names in the streams feed so you can watch users more easily.
  • mp_note
    This is the only property available in streams. It is not available in other reports.
  • token
    The token used to associate data you send Mixpanel to your account and project.

The special properties below will automatically be filled in if you use our Javascript library

  • time
    A unix time epoch that is used to determine the time of an event.
  • $initial_referrer
    The first referrer the user came from ever.
  • $initial_referring_domain
    The first referring domain the user came from ever.
  • $search_engine
    The search engine a user came from.
  • mp_keyword
    The search keyword the user used to get to your website.
  • $os
    The operating system of the user.
  • $browser
    The browser of the user.
  • $referrer
    The current referrer of the user.
  • $referring_domain
    The current referring domain of the user.
  • mp_country_code
    A two letter country code representing the geolocation of the user.

Special properties for Mixpanel People records

  • $email
    The user's email address. You must set this property if you want to send users email from Mixpanel People.
  • $phone
    The user's phone number. You must set this property if you want to send users sms messages from Mixpanel People.
  • $ios_devices
    List of user's Apple Push Notification service device tokens for iOS push. Our iOS client library has methods to manage this property for you.
  • $android_devices
    List of user's Google Cloud Messaging registration IDs for Android push. Our Android client library has methods to manage this property for you.
  • $first_name, $last_name, $name, $username
    User's first and last names and screen name. These are primarily useful because we will use them, if available, in a few spots in our reports.
  • $created
    The date the user signed up.

Limitations on Property Names

Pick your property names wisely. Once you've sent them to Mixpanel, there is no way to change them. Feel free to use capitalization and spaces in between words.

There are a few limitations:

  • Your property names should not begin with $ or mp_. These properties are reserved for special properties sent by Mixpanel.
  • Your property names cannot begin or end with a space as they will automatically be trimmed.
  • Your property names cannot be longer than 255 characters. In practice they should be much shorter than that. It gets cut off by our user interface at about 20 characters.