---
# Generated by the help-docs job in equiapp (ci/help-docs-generator) from the
# help anchor 'AdminUsersList'. Set generated to false to edit this page by hand; the job
# then leaves it alone.
title: Users
summary: >-
  Shows all app users in this organisation, their roles, and lets you invite new
  users.
helpKey: AdminUsersList
generated: true
modals:
  invite-user:
    title: Invite
    summary: Invite a new person or company to create an account in your organisation.
---

# Users

This page lists every user with a login in your organisation and the roles they have. Use it to locate users, manage their access, or invite new users.

## What's on this page
- **Invitations**: pending email invitations you have sent; you can resend or remove them.
- **Users**: the list of active users, showing name, contact details and the stable(s) they can access. The list can be filtered, searched and sorted.

## Common tasks
### Invite a new user
1. Click the **Invite user** button at the top right of the page.
2. Fill in the required fields (name, email, role, optional stables) and press **Invite**.
3. The person receives an email with a link to create an account.

### Resend or delete an invitation
1. In the **Invitations** section, click the three‑dot **icon** next to the invitation.
2. Choose **Resend** to send the invitation again, or **Remove** to cancel it.

### Find a user and open their details
1. Type a name or email in the **Search** box or apply a **Filter** (e.g. by role).
2. Click a column header (e.g. **Name**, **Contact**, **Stable**) to sort the list.
3. Click a row to open the user's detail screen.

## Good to know
- The **Invite user** button only appears if you have permission to add users.
- The **Invitations** tile is hidden when there are no pending invitations.
- Only contacts that already have a user account appear in the **Users** list.
- Filters and sorting are saved in your browser, so they persist when you return to the page.
- Scroll down to load more users; pull down to refresh the list.

<!-- help-docs: modal invite-user -->

## Invite {#invite-user}

Invite a new person or company to create an account in your organisation.

### Type of contact
- Choose **Personal** for an individual or **Business** for a company; the appropriate name fields appear.

### Email address
- Enter the email unless you selected an existing contact (or it has no email); the invitation goes to this address.

### Show in planning
- Tick to make the user appear in the staff activity planning.

### Existing contact
- If a contact with matching name or email exists, a preview appears; click **Use** to invite it or **X** to cancel.

### Stables
- Select which stables the user may access; leave empty for all.

### Roles
- Pick one or more roles that define the user's permissions.

### After saving
- The user gets an invitation email; the contact appears in the Users list and, if **Show in planning** is checked, also in the staff activity planning.