This article describes the properties that Mixpanel will collect by default. Properties are either set by our Data Ingestion API or by the official Mixpanel SDK you may be using. SDKs that append additional properties include JavaScript, iOS - Objective-C, iOS - Swift, and Android.
These special properties mostly begin with a dollar sign($). This is a common prefix to distinguish it as a Mixpanel-managed entity. These managed entities are transformed to a formatted name in our web application.
Default Properties
Ingestion API
Events and Profiles
- City (raw property name: $city)
The city of the event sender parsed from the IP property or the Latitude and Longitude properties.
Refer to Geo Source ($geo_source) below for more detail. - Region (raw property name: $region)
The region (state or province) of the event sender parsed from the IP property or the Latitude and Longitude properties.
Refer to Geo Source ($geo_source) below for more detail. - Country (raw property name: mp_country_code)
The country of the event sender parsed from the IP property or the Latitude and Longitude properties.
Refer to Geo Source ($geo_source) below for more detail. - Geo Source (raw property name: $geo_source)
This defines the method used to establish the location properties on that same entity. Location properties include Country, Region, and City.
Property values and their meaning:
- null: Location properties were determined through the IP ($ip) property.
- reverse_geocoding: Location properties were determined through the Latitude ($latitude) and Longitude ($longitude) properties.
Events Only
- Mp Api Endpoint (raw property name: $mp_api_endpoint)
This is the value of the Host Header based on the request to our ingestion service. This value will commonly be api.mixpanel.com. However, it is useful to confirm where your data was ingested if you partake in our EU Data Residency or are using a custom proxy.
Common property values and their meaning:
- api.mixpanel.com: Mixpanel's default ingestion service
- api-eu.mixpanel.com: Mixpanel's EU data ingestion service
- api-js.mixpanel.com: Mixpanel's data ingestion for the Javascript SDK
Profiles Only
- Updated at ($last_seen)
** formerly formatted as Last Seen **
The last time a user profile property was set or updated (cannot be set manually). This is now called "Updated at" in the UI.
Official SDKs
Javascript [docs]
Events
- Browser ($browser)
Browser name (not versioned). - Browser Version ($browser_version)
Browser version number. - Device ($device)
The name of the event sender's device, if they're on mobile web. - Device ID ($device_id)
A default Mixpanel property to track the device as determined by Mixpanel's client-side SDKs. Events tracked from the same device and same user but different applications may not have the same $device_id. The reset method will change the device_id. - User ID ($user_id)
A default Mixpanel property to track the $identified_id passed into identify method client-side. Stored locally on the user's device using the register method. - Current URL ($current_url)
The full URL of the webpage on which the event is triggered. - Initial Referrer ($initial_referrer)
Referring URL at first arrival.
Displays the value $direct when a user first lands on a site without being referred by another website. - Initial Referring Domain ($initial_referring_domain)
Referring domain at first arrival.
Displays the value $direct when a user first lands on a site without being referred by another website. - Operating System ($os)
OS of the event sender. - Mixpanel Library (mp_lib)
Mixpanel Library that sent the event. - Referrer ($referrer)
Referring URL, including your own domain.
Might not be present ifdocument.referrer
does not return a value. As opposed to $initial_referrer and $initial_referring_domain, this property will be omitted if the user lands directly or the referring website adds therel=“noreferrer”
parameter. - Referring Domain ($referring_domain)
Referring domain, including your own domain.
Might not be present ifdocument.referrer
does not return a value. As opposed to $initial_referrer and $initial_referring_domain, this property will be omitted if the user lands directly or the referring website adds therel=“noreferrer”
parameter. - Screen Height ($screen_height)
The height of the device screen in pixels. - Screen Width ($screen_width)
The width of the device screen in pixels. - Search Engine ($search_engine)
Search engine a customer used when they arrived at your domain. - Search Keyword (mp_keyword)
Search keywords detected on the referrer from a search engine to your domain. This property is only collected when search keywords are included in a URL. - UTM Parameters (utm_source, utm_medium, etc.)
Any utm tags associated with the link a customer clicked to arrive at your domain. Each utm will be collected under its own property. Mixpanel only tracks first touch UTM parameters by default. - Processing Time (mp_processing_time_ms)
Time in milliseconds in Unix Processing Time when an event was ingested by Mixpanel. While the "Time" property in Mixpanel is set in the time zone specified by the project, mp_processing_time_ms will always be in UTC (GMT) time. - API Timestamp ($mp_api_timestamp_ms)
Time in milliseconds in Unix Processing Time when an event was received by our API. - Insert ID ($insert_id)
A random 36 character string of alphanumeric characters that is unique to an event. Mixpanel uses $insert_id to deduplicate events.
Profiles
Default properties update within a profile whenever a property is set or updated with a mixpanel.people.set() call.
- Timezone ($timezone)
Timezone of the event sender, parsed from IP. - Browser Version ($browser_version)
Browser version number. - Browser ($browser)
Browser name (not versioned). - Initial Referrer ($initial_referrer)
Referring URL at first arrival. - Initial Referring Domain ($initial_referring_domain)
Referring domain at first arrival. - Operating System ($os)
OS of the event sender. - Last Seen ($last_seen)
The last time a user profile property was set or updated (should not be set manually). This is now called "Updated at" in the UI.
iOS
This list applies to both the iOS - Objective-C [docs] and iOS - Swift [docs] SDKs.
Events
- App Build Number ($app_build_number)
General build of this app. - App Version ($app_version_string)
Current app version. - $app_release [Deprecated]
Deprecated - $app_version [Deprecated]
Deprecated in favor of $app_version_string - Carrier ($carrier)
Wireless carrier of the device owner. - iOS Version ($os_version)
Current version of iOS on the device. - Manufacturer ($manufacturer)
Always Apple (so far...). - Lib Version ($lib_version)
Mixpanel library used to send this data. - Mixpanel Library (mp_lib)
Mixpanel Library that sent the event. - Model ($model)
Device model ID, in format "iPad 3,4". Full list here. - Device Model (mp_device_model)
Legacy device model ID, same as $model. - Device ID ($device_id)
A default Mixpanel property to track the device as determined by Mixpanel's client-side SDKs. Events tracked from the same device and same user but different applications may not have the same $device_id. The reset method will change the device_id. - User ID ($user_id)
A default Mixpanel property to track the $identified_id passed into identify method client-side. Stored locally on the user's device using the register method. - Operating System ($os)
"iPhone OS" (outdated naming convention). - Radio ($radio)
Current cellular network communication standard (3G, 4G, LTE, etc). - Screen Height ($screen_height)
Height, in points, of the device screen. - Screen Width ($screen_width)
Width, in points, of the device screen. - Wifi ($wifi)
Set to true if user’s device has an active, available Wifi connection, false if not. - Processing Time (mp_processing_time_ms)
Time in milliseconds in Unix Processing Time when an event was ingested by Mixpanel. While the "Time" property in Mixpanel is set in the time zone specified by the project, mp_processing_time_ms will always be in UTC (GMT) time. - API Timestamp ($mp_api_timestamp_ms)
Time in milliseconds in Unix Processing Time when an event was received by our API. - Insert ID ($insert_id)
A random 36 character string of alphanumeric characters that is unique to an event. Mixpanel uses $insert_id to deduplicate events.
Profiles
Default properties update within a profile whenever a property is set or updated with a mixpanel.people.set() call.
- Timezone ($timezone)
Timezone of the event sender, parsed from IP. - iOS App Release ($ios_app_release)
General build of this app. - iOS App Version ($ios_app_version)
Full detail of this app build. - iOS Device Model ($ios_device_model)
Device model ID, in format "iPad 3,4". Full list here. - iOS Lib Version ($ios_lib_version)
Mixpanel library used to send this data. - iOS Version ($ios_version)
Current version of iOS on the device. - Last Seen ($last_seen)
The last time a user profile property was set or updated (cannot be set manually). This is now called "Updated at" in the UI. - Total App Sessions
The total number of "App Session" events that the user has sent. - Total App Session Length
The total number of seconds that a user has spent using the app. This is calculated by adding the "Duration" property attached to the "App Session" event. - First App Open Date
The date the app was first opened on a user's device.
Android
Events
- App Version ($app_version_string)
Current app version. - App Build Number ($app_build_number)
General build of this app. - $app_release [Deprecated]
- $app_version [Deprecated]
Deprecated in favor of $app_version_string - Bluetooth ($bluetooth_enabled)
Set to true is Bluetooth is enabled, false if not. - Bluetooth Version ($bluetooth_version)
Set to "none", "ble", or "classic". - Brand ($brand)
Device brand. - Carrier ($carrier)
Wireless carrier of the device owner. - Has NFC ($has_nfc)
Set to true if Near Field Communication is being used, false if not. - Has Telephone ($has_telephone)
Set to true if this device has telephone functionality, false if not. - Lib Version ($lib_version)
Version of the Mixpanel library used to send this data. - Manufacturer ($manufacturer)
Device manufacturer. - Model ($model)
Device model. - Mp_device_model [Deprecated]
Deprecated - Device ID ($device_id)
A default Mixpanel property to track the device as determined by Mixpanel's client-side SDKs. Events tracked from the same device and same user but different applications may not have the same $device_id. The reset method will change the device_id. - User ID ($user_id)
A default Mixpanel property to track the $identified_id passed into identify method client-side. Stored locally on the user's device using the register method. - Mixpanel Library (mp_lib)
Mixpanel Library that sent the event. - Operating System ($os)
OS of the event sender. - Os Version ($os_version)
Current Android version for this device. - Screen DPI ($screen_dpi)
Pixel density of the device screen. - Screen Height ($screen_height)
Height, in pixels, of the device screen. - Screen Width ($screen_width)
Width, in pixels, of the device screen. - Wifi ($wifi)
Set to true if user’s device has an active, available Wifi connection, false if not. - Google Play Services ($google_play_services)
Verifies that Google Play services is installed and enabled on this device, and that the version installed on this device is no older than the one required by this client. - Processing Time (mp_processing_time_ms)
Time in milliseconds in Unix Processing Time when an event was ingested by Mixpanel. While the "Time" property in Mixpanel is set in the time zone specified by the project, mp_processing_time_ms will always be in UTC (GMT) time. - API Timestamp ($mp_api_timestamp_ms)
Time in milliseconds in Unix Processing Time when an event was received by our API. - Insert ID ($insert_id)
A random 36 character string of alphanumeric characters that is unique to an event. Mixpanel uses $insert_id to deduplicate events.
Profiles
Default properties update within a profile whenever a property is set or updated with a mixpanel.getPeople().set() call.
- Timezone ($timezone)
Timezone of the event sender, parsed from IP. - Android App Version ($android_app_version)
Current app version. - Android App Version Code ($android_app_version_code)
Current app version. - Android Lib Version ($android_lib_version)
Version of the Mixpanel library used to send this data. - Android OS Version ($android_os_version)
Current Android version for this device. - Android Brand ($android_brand)
Device brand. - Android Model ($android_model)
Device model. - Android Manufacturer ($android_manufacturer)
Device manufacturer. - Updated at ($last_seen)
** formerly formatted as Last Seen **
The last time a user profile property was set or updated (cannot be set manually). This is now called "Updated at" in the UI.
Comments
Article is closed for comments.