## What does Atlan crawl from Mixpanel?

URL: https://docs.atlan.com/apps/connectors/business-intelligence/mixpanel/references/what-does-atlan-crawl-from-mixpanel

> During a Mixpanel crawl, Atlan catalogs Lexicon events, event properties, and user (profile) properties. Reference tables map each Lexicon property to its Atlan asset, and describe bidirectional description write-back.

Atlan catalogs the governance metadata in your Mixpanel project's [Lexicon](https://docs.mixpanel.com/docs/data-governance/lexicon) (events, event properties, and user profile properties) and maps each property to its Atlan asset model. The tables below list which Lexicon properties are read and how they appear in Atlan. Atlan also writes certified descriptions back to Lexicon; see [description write-back](#description-write-back) below.

:::info Asset types
Mixpanel events and event properties are cataloged as dedicated asset types, `MixpanelEvent` and `MixpanelEventProperty`, nested under the Mixpanel connection. User (profile) properties are cataloged as Atlan **glossary terms** with the `MixpanelProfileProperty` custom metadata set attached, because a profile property is a single business definition reused across every user in a project.
:::

## Events

Atlan maps events from your Mixpanel Lexicon to its `MixpanelEvent` asset type. Each event is a distinct event type defined in the project's Lexicon—not an individual event occurrence.

| Source property | Atlan property | Where in Atlan |
| --- | --- | --- |
| Event name | `name` | asset profile and overview sidebar |
| Event description | `description` | asset profile and overview sidebar (governed in Atlan; pushed back to Lexicon) |
| Internal event ID | `sourceId` | asset profile |
| Lexicon deep link | `sourceURL` | asset profile—opens Mixpanel Lexicon in a new tab |
| Lexicon owners | `ownerUsers` / `ownerGroups` | asset profile and overview sidebar |
| Lexicon tags | `atlanTags` | asset profile |
| Created / updated timestamps | `sourceCreatedAt` / `sourceUpdatedAt` | asset profile |
| Project ID | `mixpanelProjectId` | asset profile—indexed for search |
| Lexicon status | `mixpanelStatus` (`Visible`, `Hidden`, `Dropped`, `Merged`) | asset profile |
| Business category | `mixpanelCategory` | asset profile—indexed for search |
| Firing platforms | `mixpanelPlatforms` | asset profile—indexed for search |
| 30-day volume | `mixpanelVolume30d` | asset profile |
| First / last seen | `mixpanelFirstSeenAt` / `mixpanelLastSeenAt` | asset profile |

## Event properties

Atlan maps event properties from Lexicon to its `MixpanelEventProperty` asset type. Each event property belongs to a parent event—the same property name on two different events is cataloged as two distinct assets.

| Source property | Atlan property | Where in Atlan |
| --- | --- | --- |
| Property name | `name` | asset profile and overview sidebar |
| Property description | `description` | asset profile and overview sidebar (governed in Atlan; pushed back to Lexicon) |
| Internal property ID | `sourceId` | asset profile |
| Lexicon deep link | `sourceURL` | asset profile—opens Mixpanel Lexicon in a new tab |
| Parent event | `mixpanelEvent` (relationship) + `mixpanelParentEventName` | asset profile—linked parent `MixpanelEvent` |
| Data type | `mixpanelPropertyDataType` (`string`, `number`, `boolean`, `list`, `object`, `datetime`) | asset profile |
| Property kind | `mixpanelPropertyKind` (`event_property`, `default`, `reserved`) | asset profile |
| Reserved flag | `mixpanelIsReserved` | asset profile |
| Automatically collected (SDK) flag | `mixpanelIsDefault` | asset profile |
| Customer-defined flag | `mixpanelIsCustom` | asset profile |
| Sample values | `mixpanelSampleValues` | asset profile |
| First / last seen | `mixpanelFirstSeenAt` / `mixpanelLastSeenAt` | asset profile |

> Each `MixpanelEventProperty` links to its parent `MixpanelEvent` through the `mixpanelEvent` relationship, so you can navigate from an event to every property it carries and back.

## User (profile) properties

Atlan catalogs Mixpanel user (profile) properties as Atlan **glossary terms** in a `Mixpanel User Properties` glossary, with the `MixpanelProfileProperty` custom metadata set attached to each term. A profile property is a single business definition shared across all users in the project, which maps naturally to a glossary term rather than a structural asset.

The `MixpanelProfileProperty` custom metadata set carries:

| Custom metadata attribute | Type | Description |
| --- | --- | --- |
| `mixpanelKey` | string | Raw property key (for example `$email`, `user_country`). |
| `mixpanelProjectId` | string | Mixpanel project the property belongs to. |
| `mixpanelInternalId` | string | Mixpanel internal property ID. |
| `mixpanelDataType` | enum | Property data type (`string`, `number`, `boolean`, `list`, `object`, `datetime`). |
| `mixpanelIsDefault` | boolean | Automatically collected by Mixpanel SDKs. |
| `mixpanelIsReserved` | boolean | Reserved property name. |
| `mixpanelSampleValues` | array<string> | Sample of observed values. |
| `mixpanelFirstSeenAt` | date | First observation. |
| `mixpanelLastSeenAt` | date | Last observation. |

## Description write-back

Atlan is the system of record for the definitions in your tracking plan. When a steward certifies or edits the **description** of a `MixpanelEvent` or `MixpanelEventProperty` in Atlan, the app writes that description back to the corresponding entry in Mixpanel Lexicon on its daily write-back run, keyed by the Mixpanel internal ID. Analysts working in Mixpanel see the governed definition without leaving their tool.

Write-back scope in this release:

- **Descriptions only.** Owners, tags, and status are set in Atlan for governance but aren't yet written back to Lexicon.
- **Requires edit permission.** The Mixpanel service account must have a role that can edit Lexicon for write-back to succeed. See [setting up Mixpanel](https://docs.atlan.com/llms/connectors/mixpanel/set-up-mixpanel/llms.txt).

---