# Edit User

Edit existing user profiles to update key details such as their **Name**, **Contact Number**, **Title**, and **Roles**.\
This section allows administrators to manage existing team members without affecting their login credentials or linked accounts.

> **Notes:**&#x20;
>
> Once a user has been created, their **email address, password, and SSO configuration** cannot be changed.&#x20;
>
> If the user needs to change their password, they can do this by following the forgot password process.&#x20;
>
> To update login details or transfer access between accounts, please contact <support@cloudscaff.com> for assistance.

{% hint style="info" %}
[Learn how to Reset Password](https://docs.cloudscaff.com/logout/forgot-or-reset-password)
{% endhint %}

***

## Accessing Edit User Page <a href="#accessing-user-profiles" id="accessing-user-profiles"></a>

In the **side navigation**, click **Settings → User Profiles → Click on a user in the user List**

{% hint style="info" %}
​[Click here to view how to access User Profiles](https://app.gitbook.com/o/NbjppYCBHdjT4PFa7TUI/s/sVJ0qURLvzCOxTGXEZIZ/settings/accessing-settings)
{% endhint %}

The user list displays all **active users** in your organization.

## **Open Edit User Form** <a href="#open-user-profiles" id="open-user-profiles"></a>

Click on a user in the user list. This will open the **Edit User Form**, allowing you to modify their details, roles, and permissions.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FGo7YiVNU3bk2lEn9RQoh%2FScreenshot%202025-10-30%20at%2010.25.52.png?alt=media&#x26;token=e08034e5-bd9a-46a8-b9c7-0b44b79e3a21" alt=""><figcaption></figcaption></figure></div>

If you have many users in the account, use the **search bar** to quickly find and select the user you want to edit.

{% hint style="info" %}
[Learn how to use Search](https://docs.cloudscaff.com/general-tools-and-features/search-and-filter-bar)
{% endhint %}

{% hint style="info" %}
[Learn how to use Pagination ](https://docs.cloudscaff.com/general-tools-and-features/table-pagination-and-rows-per-page-selector)
{% endhint %}

***

### **Edit User Form**

<div align="left"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2F5j5uw77pUn1oBqBsy2jr%2FScreenshot%202025-10-31%20at%2008.40.43.png?alt=media&#x26;token=c0051d45-fae7-407f-b855-8cdd80162a7f" alt=""><figcaption></figcaption></figure> <figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FSFZUb0q4SI0lk4iHClMr%2FScreenshot%202025-10-31%20at%2008.40.53.png?alt=media&#x26;token=91d1534a-fb28-43ff-946a-5785ed4c3b5f" alt=""><figcaption></figcaption></figure></div>

The Edit User form is similar to the Add User form but with the following differences:

* The **Email** field is locked and cannot be edited.
* **Password** and **SSO settings** are not displayed.
* You can update:
  * **Full Name:** The user’s first and last names — used throughout documents and logs.
  * **Contact Number:** Optional field for adding a phone number.
  * **Title:** Define the user’s position or job title (e.g., Site Manager, Supervisor, Developer).

> **Tip:** Use accurate titles and contact details — they appear on all documents and logs in the system.

***

## **Set Role and Permissions**

Click **Select Role** to open the **Role Builder**, where you can assign or remove user roles.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FucopMzluUbQzv0dC99NU%2FScreenshot%202025-10-31%20at%2010.04.02.png?alt=media&#x26;token=b611db53-8a21-4a67-848b-3181bdc80fd8" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
[Learn how to create roles and permissions](https://docs.cloudscaff.com/settings/user-management/role-builder-add-or-update-roles)
{% endhint %}

### **Selecting Roles**

The example below shows the types of roles that have been created by an administrator in the system and are available to allocate to a user.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FDUAOSJK7kDrRCTZ2V3ze%2FScreenshot%202025-10-31%20at%2008.41.02.png?alt=media&#x26;token=182bd550-4023-444f-8c56-3294063fcd4e" alt=""><figcaption></figcaption></figure></div>

Each role includes a title and a description to help you select the correct role or combination of roles for the user.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FEvlwhEhbl87cahZUlYHE%2FScreenshot%202025-10-31%20at%2010.14.34.png?alt=media&#x26;token=f2f6bd73-df1b-4d0f-a0db-a1cc60f42338" alt="" width="375"><figcaption></figcaption></figure></div>

When assigning or managing roles, you can quickly identify their function and permissions by looking at the available indicators in the list.

#### **Checkbox**

Displays which role has been selected to be applied to the user.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FDyKKuid42QTKxaVJgjOv%2FScreenshot%202025-10-31%20at%2010.11.11.png?alt=media&#x26;token=06047208-3d11-4d8d-9df7-3a127615ff5e" alt="" width="60"><figcaption></figcaption></figure></div>

#### **Permission Count**

The number displayed on the top right of the role name indicates how many permissions are set within that role.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2Fx857gt7FCzdEtEDmVRRe%2FScreenshot%202025-10-31%20at%2010.11.18.png?alt=media&#x26;token=ffe32727-4ad2-4fc7-851a-86a5593784b5" alt="" width="144"><figcaption></figcaption></figure></div>

#### **Edit Button**

If you need to modify a role, click the edit icon on the far right of the role row. This opens the Role Builder, where you can view or adjust the permissions.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FoITIkyO8NtBxAix6H4DX%2FScreenshot%202025-10-31%20at%2010.14.48.png?alt=media&#x26;token=458c202e-ad32-45dd-aede-fe8cd6e62c46" alt="" width="69"><figcaption></figcaption></figure></div>

{% hint style="info" %}
[Learn how to Add or Update Permissions to Roles](https://docs.cloudscaff.com/settings/user-management/role-builder-add-or-update-roles)
{% endhint %}

#### **Add a Role Button**

If you need to create a new role, click the yellow plus button at the bottom-right corner of the screen to open the Role Builder.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FCzRZsFFDuuRuC3OfU0d7%2FScreenshot%202025-10-30%20at%2011.10.42.png?alt=media&#x26;token=502812b8-75a0-457d-a2e1-c881c4b93588" alt="" width="70"><figcaption></figcaption></figure></div>

### You can select multiple roles where applicable.

<figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2Fk5qMACcGjcwcqpPN5rW5%2FScreenshot%202025-10-31%20at%2008.55.59.png?alt=media&#x26;token=50d8db5d-4630-4ccc-8426-f93922e04dde" alt=""><figcaption></figcaption></figure>

### Set Roles

Once selections are made, click **Set Roles** to apply your changes.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2Fhx8FZFA42IfFEQa9y5Uk%2FScreenshot%202025-10-31%20at%2010.26.04.png?alt=media&#x26;token=0c818aa2-6fba-4d9e-91fc-96d2dbb1b1fa" alt="" width="92"><figcaption></figcaption></figure></div>

***

### Visual Confirmation of Roles Being Set

The assigned roles will appear beneath the **Set Role permissions** section in the Edit User form.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2F35SuMBizbqgpIAVOqjpe%2FScreenshot%202025-10-31%20at%2008.42.29.png?alt=media&#x26;token=0c29b2ce-6ba9-4e5d-8aa5-b620a063cc58" alt="" width="375"><figcaption></figcaption></figure></div>

***

## **Saving Changes**

After updating user information and setting roles:

1. Review the fields for accuracy.
2. Click **UPDATE USER** at the bottom of the form.

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2Fa1FapC7NECpkka3PBHpE%2FScreenshot%202025-10-31%20at%2010.31.18.png?alt=media&#x26;token=d5c1aed1-55e9-4d40-b5d3-cedb136271ab" alt="" width="174"><figcaption></figcaption></figure></div>

The system will immediately apply the updates across all devices.

> **Note:** If a user is logged in while their roles are updated, they may need to refresh their session to see the new access permissions.

***

### **Best Practices**

* Review user access regularly to ensure permissions reflect current roles.
* Assign the minimum required access to maintain operational control.
* Use clear and accurate job titles for documentation and reporting consistency.

***

### **Example Workflow**

1. Navigate to **Settings → User Profiles.**
2. Select a user and click **Edit (✏️).**
3. Update the **Name**, **Contact Number**, and **Title** fields.
4. Click **Select Role** to adjust permissions.
5. Click **UPDATE USER** to confirm.

The user’s updated details and permissions will immediately reflect in all linked sections of Cloudscaff.
