Identify users

Docs

Getting started

Start here

Quickstart

Advanced

Track group behaviour

SDKs

Web

Browser React & Next.js

Server

Node.JS Python Ruby

HTTP API

Authentication Identify Group Track Page

Help center

Go to June home

See which users are using your product

Have you installed the June SDK?

If you haven't installed one of the June SDKs, please do that first before implementing the .identify method.

See how to install the June SDK →

Users

Overview

This section provides guidance on using the identify method to successfully identify your product's users. This will show you which users are triggering events in June. It is recommended to include this code snippet in the section of your code where user sign-ups, logins, or account details updates are handled.

Code

Replace USER_ID with a unique identifier, preferably the user ID from your database. Including the user's email is also suggested, along with any additional "traits" like avatar, name, role, etc. This information will appear on the user's profile and can be used to filter users in reports.

💡 Not sure which traits to add? We automatically map some standard ones: check out our guide

1
window.analytics.identify('USER_ID', {
2
  email: '[email protected]',
3
  // Optional
4
  name: 'Joe Bloggs',
5
  avatar: 'https://avatar.com/asd809sdhoif9as10nc29.png'
6
  // Add anything else about the user here
7
});

1
analytics.identify('USER_ID',{
2
    email: '[email protected]',
3
    // Optional
4
    name: 'Joe Bloggs',
5
    avatar: 'https://avatar.com/asd809sdhoif9as10nc29.png'
6
    // Add anything else about the user here
7
  });

1
analytics.identify({
2
  userId: 'USER_ID',
3
  traits: {
4
    email: '[email protected]',
5
    // Optional
6
    name: 'Joe Bloggs',
7
    avatar: 'https://avatar.com/asd809sdhoif9as10nc29.png'
8
    // Add anything else about the user here
9
  }
10
});

1
analytics.identify(
2
  user_id="USER_ID",
3
  traits={
4
    "email": "[email protected]",
5
    # Optional
6
    "name": "Joe Bloggs",
7
    "avatar": "https://avatar.com/0sd9fsd8y97a0sf99asd.png",
8
    # Add anything else about the user here
9
  },
10
)

1
Analytics.identify(
2
  user_id: 'USER_ID',
3
  traits: { 
4
    email: "[email protected]"
5
    # Optional
6
    name: "Joe Bloggs",
7
    avatar: "https://avatar.com/d78979as8hlsa9088f.png"
8
    # Add anything else about the user here
9
  }
10
)

1
curl https://api.june.so/sdk/identify
2
-H "Content-Type: application/json"
3
-H "Authorization: Basic YOUR_WRITE_KEY"
4
-X POST
5

6
{
7
  "userId": "USER_ID",
8
  "traits": {
9
    "email": "[email protected]",
10
    # Optional
11
    "name": "Joe Bloggs",
12
    "avatar": "https://avatar.com/0sd9fsd8y97a0sf99asd.png",
13
    # Add anything else about the user here
14
  },
15
  "timestamp": "2012-12-02T00:31:38.208Z"
16
}

Next: Track user behaviour

Once you've implemented the identify method in your codebase, it's time to track what your users are doing in your product.

See how to track user behaviour →