> ## Documentation Index
> Fetch the complete documentation index at: https://runrehearsals.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Identify Users Troubleshooting

> Debug common issues with user identification

> [!NOTE]
>
> If `identify()` isn't working at all, first check the [Installation Troubleshooting](https://runrehearsals.com/docs/troubleshooting/installation) guide to ensure the Rehearsals script is loaded correctly.

## Common Issues

### Users not being linked

* Verify `window.rehearsals` exists in the browser console
* Ensure you're passing a valid, non-empty user ID string
* Check that the script loaded before calling `identify()`

### Users being merged incorrectly

* Use truly unique user IDs for each user
* Don't use generic values like `'user'`, `'null'`, or `'undefined'`
* Verify your authentication system returns unique IDs

### Sessions not resetting on logout

* Call `rehearsals.reset()` in your logout handler
* Call `reset()` **before** redirecting to the login page
* Test in an incognito window to verify behavior

### Page performance issues

Don't use `await` unless necessary:

```javascript theme={null}
// Good - non-blocking
rehearsals.identify(user.email);

// Only if you need to wait
await rehearsals.identify(user.email);
```

## Need Help?

If you're having trouble with user identification, please contact our support team with:

* Your organization ID
* Example user IDs you're trying to identify
* Any error messages from the browser console
* Steps to reproduce the issue

> [card] [Contact Support](https://app.runrehearsals.com/support)
>
> Our team is here to help you get up and running


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.