--- title: "IDENTITY events" slug: "identity-events" abstract: "Understand IDENTITY events, which are used to resolve the identity of anonymous visitors to your app." --- # IDENTITY events The `IDENTITY` event[^UUID-101b62f6-b640-ed11-1057-29646ebb9fb7_N66598351b5945] is used to resolve the identity of an anonymous site visitor. `IDENTITY` events are typically captured in registration, login, and signup forms, and they contain identifying information such as the site visitor's name, email address, and phone number provided by the visitor when they sign up or log in to your site. If your organization opts in to [identity resolution](https://doc.sitecore.com/sai/en/users/sitecoreai/identity-resolution.html), you must set up `IDENTITY` event capturing on your site. Identity resolution uses the identifying information captured in `IDENTITY` events together with [identity rules](https://doc.sitecore.com/sai/en/users/sitecoreai/identity-rules.html) to recognize and match site visitor profiles. You can also set up `IDENTITY` event capturing without identity resolution. In that scenario, captures the event data without using it to resolve visitor identities. > [!note] > All data sent to for identity resolution is treated as case-insensitive. For example, the email address `John.Doe@EMAIL.com` will match `john.doe@email.com`. You can send `IDENTITY` events by using the Cloud SDK [`identity`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-browser/functions/cloud-sdk-events-browser-identity.html "identity") function and passing it the [identity event data object](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-browser/interfaces/cloud-sdk-events-identitydata.html "IdentityData"). To set up `IDENTITY` events, refer to the developer guide. ## The identity event data object The identity event data object represents all the required and optional data about the event. This is the object where [you provide data about the event](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events.html#UUID-b78ff86e-4442-71e7-edc6-81adf8fabe27_section-idm46246153457504340509825241 "The data in the events"). All this data is sent to Sitecore, so make sure to provide the correct data depending on your organization's requirements. Construct the object in the following way: - Provide the `identifiers` array. In the array, include the name of the identifier, such as *email* or *phone*, and the unique identifier, such as *john.doe@email.com* or *+3539122334455*. - Optionally, you can: - Provide data such as the channel and the language of the page where the event triggered, and personally identifiable information (PII) such as the site visitor's first name and last name. - Include the [extension data object](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events.html#UUID-b78ff86e-4442-71e7-edc6-81adf8fabe27_section-idm234411833561624 "Data provided by you"). ## Examples > [!tip] > During development, use your web browser's developer tools to [check the payload](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events.html#UUID-b78ff86e-4442-71e7-edc6-81adf8fabe27_section-idm234451877631545 "Checking the payload") containing all the event data that is sent to Sitecore. Example 2. Sending an IDENTITY event Here's an example identity event data object for an `IDENTITY` event. The object contains all the required event data, and some optional event data and extension data. You can send this event by passing the object to the `identity` function: ::::tabs :::tab{title="Browser module"} ```typescript const eventData: any = { language: "EN", page: "home", channel: "WEB", currency: "EUR", email: "jane.doe@myretailsite.com", title: "Miss", firstName: "Jane", lastName: "Doe", gender: "female", mobile: "+3531234567", phone: "+3531234567", street: ["Tara Street"], city: "Dublin", country: "IE", identifiers: [ { id: "jane.doe@email.com", provider: "email", }, ], extensionData: { customKey: "customValue" } }; identity(eventData); ``` ::: :::tab{title="Server module"} ```typescript const eventData: any = { language: "EN", page: "home", channel: "WEB", currency: "EUR", email: "jane.doe@myretailsite.com", title: "Miss", firstName: "Jane", lastName: "Doe", gender: "female", mobile: "+3531234567", phone: "+3531234567", street: ["Tara Street"], city: "Dublin", country: "IE", identifiers: [ { id: "jane.doe@email.com", provider: "email", }, ], extensionData: { customKey: "customValue" } }; await identity(request, eventData); ``` ::: :::: For this identity event data object, the following payload is sent to Sitecore: ```json { "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "channel": "WEB", "city": "Dublin", "client_key": "", "country": "IE", "currency": "EUR", "email": "jane.doe@myretailsite.com", "ext": { "customKey": "customValue" }, "firstname": "Jane", "gender": "female", "identifiers": [ { "id": "jane.doe@email.com", "provider": "email" } ], "language": "EN", "lastname": "Doe", "mobile": "+3531234567", "page": "home", "phone": "+3531234567", "pos": "", "requested_at": "2026-10-05T10:`36:32`.506Z", "street": [ "Tara Street" ], "title": "Miss", "type": "IDENTITY" } ``` [^UUID-101b62f6-b640-ed11-1057-29646ebb9fb7_N66598351b5945]: An action a site visitor performs in your app. For example, viewing a webpage, clicking a button, submitting a [SitecoreAI form](https://doc.sitecore.com/xmc/en/users/xm-cloud/en/forms.html), searching for content, or any other interaction you want to track. When an event triggers, [the event with all its data](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking.html "Tracking") is sent to Sitecore and becomes available in the various Sitecore DXP products your organization has access to. This data drives real-time, unified tracking.