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:
| 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:
[{UserLookup q='alice'}] renders as:
[{UserLookup q='$currentUser' fields='all'}] renders as:
[{UserLookup role='admin' fields='username,displayName,email'}] renders as:
[{UserLookup activeOnly='false' fields='username,displayName,isActive'}] renders as:
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).