Distinct IDs

Available since v2.18.0

A Distinct ID is a unique identifier assigned to a user, either anonymously or when they log in. This allows you to associate actions (page views, clicks, conversions) with a single user across multiple sessions. For a more extensive way to identify a session, take a look at Session Data.

Use Cases

• Properly attribute user behavior.
• Connect events across multiple sessions or devices.
• Identify repeat users vs. new users.
• Build out journeys and profiles based on user history.

Usage

You can set a Distinct ID using the umami.identify() tracker function:

umami.identify({ id: '[email protected]' });

Or by adding the id property to the event payload when using the Sending stats API directly:

{
  "payload": {
    "hostname": "your-hostname",
    "language": "en-US",
    "referrer": "",
    "screen": "1920x1080",
    "title": "dashboard",
    "url": "/",
    "website": "your-website-id",
    "id": "[email protected]"
  },
  "type": "event"
}

The id property has a 50 character limit. If your identifiers are longer, consider using a hash or shortened version.

Search

Navigate to Sessions to view visitor activity.

Search for a specific Distinct ID to view all connected sessions for that time range.