---
title: "User info event"
slug: "user-info-event"
abstract: "Explains composition and usage of the Sitecore Discover user info event object."
---
# User info event

The `user info` event (`user:info`) must be sent whenever user information is updated or when user information is available to be sent, such as when it is accessed in a customer system. This event is used in linking a real user ID to a [uuid](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/integrate-using-discover-rest-apis/events-data-model/event-specifications/funnel-events/tracking-site-visitor-information.md "Tracking site visitor information") to help in more advanced use cases such as cross-device personalization.

The following table lists the properties of the `user info` event:

| Name | Type | Description | Value |
| --- | --- | --- | --- |
| `type` | string | Required.<br><br>Type of the event. | `user` |
| `name` | string | Required.<br><br>Name of the event. | `info` |
| `value.context.user` | object | Required.<br><br>[User object](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/integrate-using-discover-rest-apis/events-data-model/event-specifications/funnel-events/the-user-object.md "The user object") that contains permanent user information. Used to build a user profile and map a temporary ID (`uuid` or `user_id`) to the user's permanent identifier. Enables cross-device personalization. | n/a |
| `value.context.page` | object | Required if the site is set up with locale configuration.<br><br>Adds page-specific information (including locale information) under [page object](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/integrate-using-discover-rest-apis/events-data-model/event-specifications/funnel-events/the-page-object.md "The page object"). | n/a |

## Sample event specification

The following is an example of a `user info` event object. This example is in the new format, which means it contains a `context` object.

```JSON
{
  "type": "user",
  "name": "info",
  "value": {
    "context": {
      "user": {
        "id": "user-1234",
        "email": "abc.def@email.com",
        "eid": "<hash_of_email>",
        "fbid": "<facebook_id>",
        "address": {
          "address_line_1": "123 Main Street",
          "address_line_2": "apartment 123",
          "state": "CA",
          "zip": "90210",
          "country": "US"
        },
        "gender": "female",
        "groups": [
          "group1",
          "group2"
        ],
        "addn_attributes": {
          "email_subscriber": "True",
          "preferred_sizes": [
            "S",
            "M",
            "32W",
            "30L"
          ],
          "home_store_code": "4321"
        }
      },
      "page": {
        "locale_country": "<country code, 2 letters, lowercase, e.g. fr>",
        "locale_language": "<language code 2 letters, lowercase, e.g. en>",
        "locale_currency": "<currency code, 3 letters, lowercase, e.g. eur>"
      }
    }
  }
}
```