Skip to main content

Next.js — Alias

Link an alias (e.g. anonymous ID) to a user. Use this to merge anonymous events (from before login) with the identified user. Available on both client and server.

Client: useSignal

Get alias from useSignal():

Client: alias(alias)

Links an alias to the current user. Sends a $create_alias event. When to use: After login to merge anonymous events (from before login) with the identified user.

Server: alias(distinctId, alias, sessionId?, windowId?)

Link an alias to a user from the server. Pass sessionId and windowId for client correlation.

How it works

  1. Before login: User browses anonymously. Events are tracked with an anonymous ID.
  2. After login: Call identify(userId, traits) to set the user’s identity.
  3. Link alias: Call alias(anonymousId) to link the anonymous ID to the identified user.
  4. Result: All events (both anonymous and identified) are now associated with the same user profile.

See also