Skip to content
Main Project

Identify your users (and what each trait gives you)

Guide

Identifying users is the single most valuable thing you can do after installing the widget. It unlocks segmentation, two-way replies, idea voting, and per-article feedback signals.

The minimum

window.Releaseo?.identify({
  id: 'user_8231',
  email: 'aya@acme.com'
});

Pass id as your stable user identifier. Email isn't required, but it lets the widget send replies back when users miss them.

Add traits for segmentation

window.Releaseo?.identify({
  id: 'user_8231',
  email: 'aya@acme.com',
  name: 'Aya M.',
  traits: {
    plan: 'pro',
    role: 'admin',
    signupAt: '2025-04-12',
    locale: 'en-US'
  }
});

Traits power every audience filter in Releaseo. Target a changelog post to "Pro plan only", show roadmap items to "admins" only, send a help signal email only to users who signed up in the last 30 days.

Re-identify on every page load

Call identify once the user object is available. The widget caches it for the session.

What identified users get

  • Roadmap voting — anonymous visitors can read; identified users can vote.

  • Feature request comments — same.

  • Inbox replies — replies from your team are pushed back to identified users.

  • Per-article quality signals — helpful/not helpful surveys are attributed to a real user.