Default Properties

Mixpanel's Data Ingestion APIs (opens in a new tab) and Client-Side SDKs automatically collect certain properties on every event or user profile. Do also note that some Customer Data Platforms (CDPs) that integrate with Mixpanel may also map their own properties to Mixpanel default properties. This document describes what those properties mean.

Ingestion APIs

Mixpanel’s ingestion APIs can collect user geolocation data (City, Region, Country) as properties if IP address is present. Our client-side SDKs by default pull the user’s IP address when sending data to our ingestion APIs. The IP address is then cross-referenced against a local copy of MaxMind’s (third-party IP geolocator (opens in a new tab)) GeoIP database to estimate geolocation data. Mixpanel does not store the IP address and is discarded once geolocation data is derived.

To disable capturing of geolocation properties (i.e. City, Region, Country) refer to the respective SDKs or API documentation. For a quick reference, refer to examples on disabling geolocation on client-side SDKs and server-side best practice on tracking geolocation. Note that there is currently no means to selectively disable one or two of the three geolocation properties.

Event Properties

Raw Name	Display Name	Description
$city	City	The city of the event sender parsed from the IP property or the Latitude and Longitude properties.
$region	Region	The region (state or province) of the event sender parsed from the IP property or the Latitude and Longitude properties.
mp_country_code	Country	The country of the event sender parsed from the IP property or the Latitude and Longitude properties. The value is stored as a 2-letter country code in the raw data and parsed into the country name in the UI.
$mp_api_endpoint	API Endpoint	Mixpanel property to record the API endpoint the data was sent to: api.mixpanel.com - default ingestion api-eu.mixpanel.com - EU data ingestion api-js.mixpanel.com - Javascript SDK
$import	Import	Internal Mixpanel property set to `true` to indicate that events were sent through /import API (opens in a new tab).
$mp_api_timestamp_ms	API Timestamp	UTC timestamp in milliseconds when the event was received by our API.
mp_processing_time_ms	Time Processed (UTC)	UTC timestamp in milliseconds when the event was processed by Mixpanel servers.

User Properties

Do note that Mixpanel's default user properties are only updated when you send or update at least one property yourself (via $set (opens in a new tab) or $set_once (opens in a new tab) operations). Please, refer to this article to understand how to send or update profile properties.

Raw Name	Display Name	Description
$city	City	The city of the user parsed from the IP property or the Latitude and Longitude properties.
$region	Region	The region (state or province) of the user parsed from the IP property or the Latitude and Longitude properties.
$country_code	Country Code	The country of the user parsed from the IP property or the Latitude and Longitude properties. The value is stored as a 2-letter country code in the raw data and parsed into the country name in the UI.
$geo_source	Geo Source	Set to "reverse_geocoding" if profile geolocation properties (Country Code, Region, and City) were determined through Latitude and Longitude.
$timezone	Timezone	Timezone of the user parsed from the IP property or the Latitude and Longitude properties.
$last_seen	Updated at	The last time a user profile property was set or updated (this should not be set manually). Passing `$ignore_time` as `true`, typically for server-side updates, will skip updating the $last_seen property. See example here.

Client-side SDKs

Note that the following SDKs wrap around our other SDKs; and as such, would also inherit the appropriate default properties from these wrapped SDKs indicated in the tables below:

React Native wraps around Android and Swift SDK; mp_lib will be set to react-native with $lib_version set as React Native's library version.
Flutter wraps around Javscript, Android, and Swift SDK; mp_lib will be set to flutter with $lib_version set as the Flutter's library version.

Event Properties

Raw Name	Display Name	Description Scroll right to see more columns -->	Javascript	Android	iOS Objective-C / Swift	Unity
$device_id	Device ID	Autogenerated ID that is local to the device. Calling reset() regenerates this value. More details here.	✅	✅	✅	❌
$user_id	User ID	The identified ID of the user. Calling identify() sets this. More details here.	✅	✅	✅	❌
$insert_id	Insert ID	A unique identifier for the event, used to deduplicate events that are accidentally sent multiple times. More details here (opens in a new tab).	✅	✅	✅	✅
mp_lib	Mixpanel Library	The Mixpanel library that sent the event.	`web`	`android`	`iphone` / `swift`	`unity`
$lib_version	Library Version	Mixpanel library version.	✅	✅	✅	✅
mp_sent_by_lib_version	Sent By Library Version	Mixpanel library version used to send data (not necessarily the same as the version which enqueued the data).	✅	❌	❌	❌
$os	Operating System	OS of the event sender.	✅	✅	✅	✅
$os_version	OS Version	The current version of operating system on the device.	❌	✅	✅	✅
$browser	Browser	Name of the browser.	✅	❌	❌	❌
$browser_version	Browser Version	Version of the browser.	✅	❌	❌	❌
$app_build_number	App Build Number	General build of the app.	❌	✅	✅	❌
$app_version_string	App Version	Current app version.	❌	✅	✅	✅
$device	Device	Name of the event sender’s device, if they’re on mobile web.	✅	❌	❌	✅
$screen_height	Screen Height	The height of the device screen in pixels / points (iOS).	✅	✅	✅	✅
$screen_width	Screen Width	The width of the device screen in pixels / points (iOS).	✅	✅	✅	✅
$screen_dpi	Screen DPI	Pixel density of the device screen.	❌	✅	❌	✅
$current_url	Current URL	The URL of the page on which the event was tracked.	✅	❌	❌	❌
$initial_referrer	Initial Referrer	Referring URL when the user first arrived on your site. Defaults to "$direct" if the user is not referred.	✅	❌	❌	❌
$initial_referring_domain	Initial Referring Domain	Referring domain at first arrival. Defaults to "$direct" if the user is not referred.	✅	❌	❌	❌
$referrer	Referrer	Referring URL including your own domain. Might not be present if document.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 the rel="noreferrer" parameter.	✅	❌	❌	❌
$referring_domain	Referring Domain	Referring domain including your own domain. Might not be present if document.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 the rel="noreferrer" parameter.	✅	❌	❌	❌
$search_engine	Search Engine	The search engine that the customer used when they arrived at your domain.	✅	❌	❌	❌
mp_keyword	Search 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_source, utm_medium, etc.	UTM Parameters	UTM tags derived from the URL a customer clicked to arrive at your domain. Each UTM will be collected under its own property. More details here.	✅	❌	❌	❌
$manufacturer	Manufacturer	Device manufacturer.	❌	✅	✅	✅
$brand	Brand	Device brand.	❌	✅	❌	❌
$model	Model	The model of the device.	❌	✅	✅	✅
$watch_model	Watch Model	The model of the iOS watch.	❌	❌	✅	❌
$carrier	Carrier	Wireless carrier of the device owner.	❌	✅	✅	❌
$radio	Radio	Current cellular network communication standard (opens in a new tab)(opens in a new tab) (3G, 4G, LTE, etc).	❌	❌	✅	✅
$wifi	Wifi	Set to true if the user’s device has an active, available Wifi connection, false if not.	❌	✅	✅	✅
$bluetooth_enabled	Bluetooth	Set to true if Bluetooth is enabled, false if not.	❌	✅	❌	❌
$bluetooth_version	Bluetooth Version	Set to "none", "ble", or "classic".	❌	✅	❌	❌
$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.	❌	✅	❌	❌
$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.	❌	✅	❌	❌
$duration	Duration	A property that is appended to an event to capture the elapsed time (in seconds) between a `time_event` and a `track` call. See time_event (opens in a new tab) in Javascript SDK for example.	✅	✅	✅	✅

User Properties

Raw Name	Display Name	Description Scroll right to see more columns -->	Javascript	Android	iOS Objective-C / Swift	Unity
$lib_version	Library Version	Last used Mixpanel library version (also applies to React Native and Flutter wrapper SDKs).	❌	❌	❌	✅
$android_lib_version	Android Lib Version	Last used Mixpanel Android / Unity library version.	❌	✅	❌	✅
$ios_lib_version	iOS Lib Version	Last used Mixpanel iOS / Unity library version.	❌	❌	✅	✅
$swift_lib_version	Swift Lib Version	Last used Mixpanel Swift library version.	❌	❌	✅	❌
$os	Operating System	Last OS of the event sender.	✅	✅	✅	✅
$android_os	Android OS	Set when Android operating system was used.	❌	✅	❌	✅
$android_os_version	Android OS Version	Last version of Android on the device.	❌	✅	❌	✅
$ios_version	iOS Version	Last version of iOS on the device.	❌	❌	✅	✅
$browser	Browser	Name of the browser.	✅	❌	❌	❌
$browser_version	Browser Version	Version of the browser.	✅	❌	❌	❌
$android_app_version	Android App Version	Current Android app version (versionName (opens in a new tab)).	❌	✅	❌	✅
$android_app_version_code	Android App Version Code	Current Android app version code (versionCode (opens in a new tab)).	❌	✅	❌	❌
$ios_app_release	iOS App Release	The release or version number of the iOS app (CFBundleShortVersionString (opens in a new tab)).	❌	❌	✅	✅
$ios_app_version	iOS App Version	The version of the build that identifies an iteration of the iOS app (CFBundleVersion (opens in a new tab)).	❌	❌	✅	❌
$initial_referrer	Initial Referrer	Referring URL when the user first arrived on your site. Defaults to "$direct" if the user is not referred.	✅	❌	❌	❌
$initial_referring_domain	Initial Referring Domain	Referring domain at first arrival. Defaults to "$direct" if the user is not referred.	✅	❌	❌	❌
initial_utm_source, initial_utm_medium, etc.	Initial UTM Parameters	UTM tags seen for the first time from the URL a customer clicked to arrive at your domain. Each UTM will be collected under its own property. More details here.	✅	❌	❌	❌
$android_manufacturer	Android Manufacturer	Android device manufacturer.	❌	✅	❌	❌
$android_brand	Android Brand	Android device brand.	❌	✅	❌	❌
$android_model	Android Model	The model of the Anroid device.	❌	✅	❌	✅
$ios_device_model	iOS Device Model	The model of the iOS device.	❌	❌	✅	✅

Data Type Reserved Properties

Was this page useful?