# Create and manage users

### PUQcloud Panel

##### [Order Now](https://puqcloud.com/puqcloud-panel.php) | [Download](https://github.com/puqcloud/PUQcloud) | [FAQ](https://faq.puqcloud.com/)

This guide explains how administrators can create users, view their client associations, edit details, and remove users in **PUQcloud Panel**.

- - - - - -

#### Overview

- **Path:** **Menu → Clients → Manage Users**
- **You can:**
    
    
    - Create a new **User** (login identity).
    - View a user’s **associated clients** and statuses.
    - **Edit** contact info, language, verification flags, and 2FA.
    - **Delete** a user account.
- **Who:** Staff with permission to manage users.

<p class="callout info">**Tip:** A **User** is a person’s login. A **Client** is an account/business they belong to. One user can be associated with multiple clients (e.g., consultant, owner). Permissions are managed from the **Client → Users** tab.</p>

- - - - - -

#### List View (Manage Users)

In the table you’ll see: avatar, name, status badges (e.g., **ACTIVE**, **INACTIVE**, **NEW**), **2FA** indicator, contact details (email, phone), **Clients** counter with an **eye** button, **Created** date, and row actions (**Edit**, **Delete**). Use **Search** to filter.

*(Screenshot: View/Search Users list view)*

[![image-1756900409222.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756900409222.png)](https://doc.puq.info/uploads/images/gallery/2025-09/image-1756900409222.png)

- - - - - -

#### Create a User

1. Go to **Clients → Manage Users** and click **+ Create**.   
    *(Screenshot: Create User modal)*
    
    [![image-1756900425343.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756900425343.png)](https://doc.puq.info/uploads/images/gallery/2025-09/image-1756900425343.png)
2. Fill the fields:
    
    
    - **Email** *(required)*
    - **Password** *(required)*
    - **2FA** *(toggle; optional but recommended)*
    - **Firstname**, **Lastname**
    - **Phone Number** *(with country code)*
    - **Language** *(UI language for the user)*
    - **Admin Notes** *(internal only)*
3. Click **Save**. The user appears in the list.

<p class="callout info">**Next step:** Associate this user with a client from **Clients → Manage Clients → open a client → Users tab → + Associate User** (choose permissions there).</p>

- - - - - -

#### View a User’s Clients

1. In **Manage Users**, find the user.
2. Click the **eye** icon in the **Clients** column.
3. In **User Clients** modal, review:
    
    
    - **User Information:** UUID, Name, Email, Phone.
    - **Associated Clients:** Client Name, Company Name, Tax ID, and **Status** badges (e.g., **ACTIVE**, **OWNER**).
4. Close when done.

*(Screenshot: User Clients modal)*

[![image-1756900477431.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756900477431.png)](https://doc.puq.info/uploads/images/gallery/2025-09/image-1756900477431.png)

- - - - - -

#### Edit a User

1. In **Manage Users**, click the **Edit** (pencil) icon on the desired row.   
    *(Screenshot: Edit User modal)*
    
    [![image-1756900500443.png](https://doc.puq.info/uploads/images/gallery/2025-09/scaled-1680-/image-1756900500443.png)](https://doc.puq.info/uploads/images/gallery/2025-09/image-1756900500443.png)
2. Update fields:
    
    
    - **Email**, **Password** (to reset), **Firstname**, **Lastname**
    - **Phone Number**, **Language**, **Admin Notes**
    - Verification toggles: **Email Verified**, **Phone Verified**
    - Security toggle: **2FA** (enable/disable)
3. Click **Save**.

- - - - - -

#### Delete a User

1. In **Manage Users**, click the **Delete** (trash) icon.
2. Confirm the action.

- - - - - -

#### Field Reference

<table id="bkmrk-field-where-descript"><thead><tr><th>Field</th><th>Where</th><th>Description</th></tr></thead><tbody><tr><td>Email</td><td>Create/Edit</td><td>User’s login email. Must be unique.</td></tr><tr><td>Password</td><td>Create/Edit</td><td>Set/reset the user’s password.</td></tr><tr><td>2FA</td><td>Create/Edit</td><td>Turn on two‑factor authentication for extra security.</td></tr><tr><td>Firstname / Lastname</td><td>Create/Edit</td><td>User’s display name.</td></tr><tr><td>Phone Number</td><td>Create/Edit</td><td>Stored with international country code.</td></tr><tr><td>Language</td><td>Create/Edit</td><td>UI language for this user.</td></tr><tr><td>Admin Notes</td><td>Create/Edit</td><td>Internal notes visible to admins only.</td></tr><tr><td>Email Verified</td><td>Edit</td><td>Mark whether the email has been verified.</td></tr><tr><td>Phone Verified</td><td>Edit</td><td>Mark whether the phone has been verified.</td></tr></tbody></table>

- - - - - -

#### Good Practices

- Require **strong passwords** and **2FA** for staff.
- Keep **contact info** and **language** up to date.
- Use **Admin Notes** to capture context (e.g., who requested access, ticket link).
- Manage access at **Client → Users** (set granular permissions per client).

- - - - - -

#### Troubleshooting

- **Cannot log in** → Reset **Password**; ensure **Email Verified** is On; check if the user is **ACTIVE**.
- **User can’t see a client** → Associate them in **Client → Users**, verify **status** and **permissions**.
- **2FA lockout** → Temporarily disable **2FA** in **Edit**, then re‑enroll.
- **Duplicate email** → Each user must have a unique email; rename or remove old account.