---
title: "tinymce.UserLookup"
description: "TinyMCE User Lookup API Handles user information retrieval and caching."
canonical_url: "https://www.tiny.cloud/docs/tinymce/latest/apis/tinymce.userlookup/"
md_url: "https://www.tiny.cloud/docs/tinymce/latest/apis/tinymce.userlookup/index.md"
version: "latest"
last_updated: "2025-07-23T02:45:48Z"
tokens: 394
---
# tinymce.UserLookup

TinyMCE User Lookup API Handles user information retrieval and caching.

## Examples

```javascript
// Get the current user's ID from the editor options, or defaults to 'Anonymous'.
tinymce.activeEditor.userLookup.userId;

// Fetch user information by IDs which returns a record of promises
const userPromises = tinymce.activeEditor.userLookup.fetchUsers(['user-1', 'user-2']);

// Access individual promises by user ID
userPromises['user-1'].then(user => console.log('User 1:', user));
userPromises['user-2'].then(user => console.log('User 2:', user));

// Or wait for all promises
Promise.all(Object.values(userPromises)).then((users) => {
  users.forEach(user => console.log('User found:', user));
}).catch((error) => {
  console.error('Error fetching users:', error);
});
```

## Summary

### Properties

| Name | Type | Summary | Defined by |
| --- | --- | --- | --- |
| userId | `String` | The current user’s ID retrieved from the editor options, or defaults to 'Anonymous'. | `UserLookup` |

### Methods

| Name | Summary | Defined by |
| --- | --- | --- |
| [fetchUsers()](#fetchUsers) | Fetches user information using a provided array of userIds. | `UserLookup` |

## Methods

### fetchUsers()

```javascript
fetchUsers(userIds: string[]): Record<UserId, Promise<User>>
```
Fetches user information using a provided array of userIds.

#### Parameters

- `userIds (string[])` - - A list of user IDs to fetch information for.

#### Return value

- `Record<UserId, Promise<User>>` - An object where each key is a user ID and its value is a Promise that resolves to the user’s data or rejects if the user is not found.