# Users

Manage **regular platform users** here — people who are not Cuppa employees and not business staff.

**Menu:** People → **Users**  
**URL:** `/dashboard/users`

---

## Who appears on this page?

| Shows | Does not show |
|-------|----------------|
| Regular users (`USER` account type) | Employees |
| | Dev accounts |
| | Business owners |
| | Business staff |

---

## Badge icon

| Icon + label | Meaning |
|--------------|---------|
| User | Regular platform user |

---

## Add a user

1. Go to **People → Users**.
2. Click **Add user**.
3. Fill in name, username, email, and password.
4. Under **Access & status**:
   - Pick a **global role** (usually `USER`)
   - Keep **Active account** checked
5. Click **Create**.

> New users from this page are always account type **User**. You do not need to pick a type — it is set automatically.

---

## Edit a user

1. Search or scroll to find the user.
2. Click **Edit** (pencil icon).
3. Update fields and click **Update**.

---

## Search and pages

- Use the **search box** to filter by name, username, or email.
- Use **Previous / Next** at the bottom to move between pages.

---

## Impersonate

Same as Employees — click the mask icon to view the app as that user. Exit via the top banner.

---

## Permissions needed

Same as Employees page: `USERS_VIEW`, `USERS_CREATE`, `USERS_UPDATE`, `USERS_DELETE`, `USERS_IMPERSONATE`.

---

## Common mistakes

| Mistake | Fix |
|---------|-----|
| Looking for a café manager here | Check **Businesses → [business] → Staff** |
| User should manage a business | Add them as **business staff**, not as a platform user only |
| User has no access to anything | Check their **global role** under System → Roles |

---

## Related guides

- [Who is who?](./02-who-is-who.md)
- [Employees](./03-employees.md)
- [Business panel — Staff](./06-business-panel.md#staff)