User Interface

An interface describing the authenticated User for a request.

You should provide at least one of id, email, ip_address, username for Sentry to be able to tell you how many users are affected by one issue, for example. Sending a user that has none of these attributes and only custom attributes is valid, but not as useful.


The application-specific internal identifier for the user.

The username. Typically used as a better label than the internal id.

An alternative, or addition, to the username. Sentry is aware of email addresses and can display things such as Gravatars and unlock messaging capabilities.

The user's IP address. If the user is unauthenticated, Sentry uses the IP address as a unique identifier for the user. Set to "{{auto}}" to let Sentry infer the IP address from the connection.

All other keys are stored as extra information but not specifically processed by Sentry.

An optional object describing the geographical location of the end user or device, this object is automatically inferred by Relay if ip_address is provided.

Geographical location

Approximate geographical location of the end user or device.


Human readable city name.

Two-letter country code (ISO 3166-1 alpha-2).

Human readable region name or code.

Automatic IP addresses

SDKs running on client platforms, such as browsers and mobile applications, should set ip_address = "{{auto}}" by default. Server-side SDKs should populate the Request Interface, instead. Sentry employs several fallbacks to backfill the IP address:

  1. Use user.ip_address, if set directly.
  2. Fall back to http.env.REMOTE_ADDR, if available.
  3. The connection's IP address as seen by Sentry, if {{auto}} was used.


  "user": {
    "id": "unique_id",
    "username": "my_user",
    "email": "",
    "ip_address": "",
    "subscription": "basic"
You can edit this page on GitHub.