Last verified: 2026-05-19
Invite and manage staff
Invite team members by email, assign a role and location scope, and manage active staff accounts.
Who can do this
| Role | Access |
|---|---|
| Admin | Yes |
| Staff | Only with staff-management permissions (uncommon) |
Dashboard paths
| Area | Route |
|---|---|
| Staff list | /admin/staff |
| Invitations | /admin/staff/invitations |
| Role templates | /admin/staff/roles |
Page title for invitations: Staff Invitations — Manage and track staff invitation requests.
Prerequisites
- Organization and at least one location (sub-organization) created
- Role templates defined if you use custom roles (
/admin/staff/roles)
Steps
1. Review roles
- Open Dashboard → Staff → Roles (
/admin/staff/roles). - Confirm built-in or Custom roles match job functions (orders, inventory, financials, etc.).
- Custom roles drive hierarchical permissions sent with each invitation.
2. Send invitations
- Open Staff Invitations (
/admin/staff/invitations). - Click Send Invitation to open the Send Staff Invitation dialog.
- Email Addresses (required): enter one or more emails; use Add Email for bulk invites.
- Role (required): choose from the dropdown (custom roles show (Custom)).
- Locations (optional): check specific branches/properties, or leave empty for organization-wide access (all current and future locations).
- Review Invitation Preview (role name and location badges).
- Click Send Invitation or Send N Invitations for bulk sends.
- Wait for progress UI (Sending Invitations…) and success toasts.
Invitations expire after 7 days if not accepted.
3. Invite acceptance (staff side)
- Invitee opens the link from email →
/invite/{token}. - Page shows Staff Invitation with organization and inviter details.
- Invitee either:
- Sign In & Accept Invitation (existing account), or
- Create Account & Accept Invitation (first name, last name, password).
- After acceptance, staff lands on
/staff.
4. Manage existing staff
- Open Staff (
/admin/staff) to view members, deactivate users, or adjust assignments (per UI).
Verify it worked
- Invitation appears on Staff Invitations with a sent/pending status.
- Invitee completes
/invite/{token}without “expired” or “invalid token” errors. - New staff user sees
/staffwith menus matching the assigned role (Understand staff permissions).
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| “Active invitation already exists” | Duplicate pending invite | Revoke/wait or use another email |
| Invitee sees empty menus | Role too restrictive | Edit role or re-invite with broader permissions |
| Invitation expired | Older than 7 days | Send a new invitation |
| No locations listed | No sub-orgs yet | Set up organization first |