The UserLookupPlugin searches users and displays results as a sortable table. What you can see depends on your permissions — administrators see full profiles; other users see names only.
Use this plugin to embed a live user directory on any page. Results are filtered and sorted in the table — click any column heading to re-sort. See Plugins for a complete list of available plugins.
[{UserLookup}] renders as:
| Username | Display Name | Last Login | Active | |
|---|---|---|---|---|
| admin | Administrator | [email protected] | 2026-05-23T20:21:57.290Z | ✓ |
| jim | jim | [email protected] | 2026-05-16T19:53:48.073Z | ✓ |
| Parameter | Default | Description |
|---|---|---|
q | *(none)* | Search query — matches against username, display name, or email. Supports $currentUser to search for the logged-in user. |
role | *(none)* | Limit results to users who have this role. |
fields | username,displayName | Columns to show. Use all for every field your account can see, or a comma-separated list: username, displayName, email, roles, lastLogin, isActive. |
max | 50 | Maximum number of rows. Use 0 for unlimited. |
activeOnly | true | Set to false to include inactive accounts. |
[{UserLookup}] renders as:
| Username | Display Name | Last Login | Active | |
|---|---|---|---|---|
| admin | Administrator | [email protected] | 2026-05-23T20:21:57.290Z | ✓ |
| jim | jim | [email protected] | 2026-05-16T19:53:48.073Z | ✓ |
[{UserLookup q='alice'}] renders as:
No users found.
[{UserLookup q='$currentUser' fields='all'}] renders as:
No users found.
[{UserLookup role='admin' fields='username,displayName,email'}] renders as:
| Username | Display Name | |
|---|---|---|
| admin | Administrator | [email protected] |
| jim | jim | [email protected] |
[{UserLookup activeOnly='false' fields='username,displayName,isActive'}] renders as:
| Username | Display Name | Active |
|---|---|---|
| admin | Administrator | ✓ |
| jim | jim | ✓ |
email, roles, lastLogin, and isActive fields are only visible to users with the user-read permission. Requesting fields='all' returns only the fields your account is permitted to see.$currentUser is replaced with your username before the search runs — it works on shared pages so each visitor sees their own record.isActive displays as ✓ (active) or ✗ (inactive).