What This Screen Does

This is where you update an existing user’s information. Think of it like pulling up someone’s contact card and making changes — you can fix a typo in their name, update their address, change their role, or even ban their account. When you save, the system updates their profile with the new details.

How to Get There

Open the dashboard.
In the left-hand menu, click User.
Find the user you want to edit in the list and click on them (or click the edit action).
You are now on the Edit User screen.

Step-by-Step Guide

1. Update the Profile Photo

On the left side of the form you will see the user’s current profile photo.
Click it to open the image uploader.
Pick an image from your computer (JPEG, JPG, PNG, or GIF).
The image will be cropped into a square — adjust the crop area and confirm.
The photo is required. If you need to change it, simply click the current image and upload a new one.

2. Review the Account Status

At the top-right corner of the profile card, you will see a colored label showing the user’s current status:
- Green = Active
- Red = Banned
- Yellow = Any other status
This gives you a quick glance at whether the account is in good standing.

3. Ban or Unban the User (optional)

Below the profile photo, you will see the Banned toggle.
Switch it on to ban the user. This disables their account.
Switch it off to make the user active again.
Use this when someone should no longer have access to the system, but you want to keep their record.

4. Set Email Verification

The Email Verified toggle controls whether the user’s email is considered verified.
When turned on: The user’s email is marked as verified.
When turned off: The system will automatically send the user a verification email.
Use this if a user reports they never received their verification email — toggle it off to trigger a new one.

5. Update Personal and Contact Information

These fields appear on the right side of the form:

Field	Required	What to Enter
Full Name	Yes	The user’s full name.
Email Address	Yes	A valid email address (e.g. `name@example.com`). Used for login and notifications.
Phone Number	Yes	The user’s phone number.

6. Update Location and Address

Field	Required	What to Enter
Country	Yes	Start typing a country name and pick from the dropdown list. Each option shows the country flag, code, and phone prefix.
State/Region	Yes	The state, province, or region.
City	Yes	The city name.
Address	Yes	Street name and number.
Zip/Code	Yes	Postal or ZIP code.

7. Update Company and Role

Field	Required	What to Enter
Company	Yes	The company or organization the user belongs to.
Role	Yes	The user’s role in the system (e.g. “Admin”, “Manager”, “Staff”).

8. Save Changes

Click the Save Changes button at the bottom-right of the form.
The system will:
1. Validate all your inputs.
2. Update the user record with the new information.
3. Redirect you back to the user list.
You will see a green “Update success!” notification at the bottom of the screen.

9. Delete the User (optional)

At the bottom of the left-side profile card, there is a red Delete User button.
Click it if you need to remove this user entirely from the system.
Be careful — this action may not be reversible. Only use it when you are sure the user should be removed.

What Happens Behind the Scenes

You click "Save Changes"
        |
        v
Form validates all fields (Yup schema checks for required fields, valid email format)
        |
        v
API call: Update user record with the new form data
        |
        v
User record is updated on the server
        |
        v
Success notification ("Update success!") appears
        |
        v
You are redirected to /users (the user list)

Troubleshooting

“I clicked Save Changes but nothing happens”

Make sure all required fields are filled in. The form will not submit if anything is missing.
Look for small red error messages below the fields — they tell you exactly what needs to be fixed.
Scroll through the entire form to check for errors you might have missed at the bottom.

“The email field shows an error”

The email must be in a valid format, such as name@example.com.
Make sure there are no spaces before or after the address.
Double-check that you have not accidentally pasted extra characters.

“I cannot find the user I want to edit”

Go back to the User list and make sure you are looking at the correct page.
Try searching or filtering the list by name or email.
If the user does not appear at all, they may not have been created yet — check with your administrator.

Start typing the country name — the list filters as you type.
If the dropdown is empty, try refreshing the page. The country data is loaded when the page opens.
Check your internet connection if the problem persists.

“I accidentally banned a user”

Go back to the user’s edit screen.
Find the Banned toggle on the left-side card and switch it off.
Click Save Changes to restore the user’s active status.
The user should be able to log in again immediately.

“My profile photo upload is not working”

Make sure the image is a JPEG, JPG, PNG, or GIF file.
The file must not exceed the maximum allowed size.
Try a different image to rule out a corrupted file.
If the issue continues, save the other changes first, then come back and try the photo upload again.

“I see a red error message after clicking Save”

Read the error message carefully — it usually describes the issue.
Common causes include: a duplicate email address already in use, a server timeout, or a missing required field.
Try again after a moment. If the error keeps appearing, contact your system administrator with the exact error message.

“The status label shows the wrong color”

The status label updates based on the Banned toggle. If you just changed it, click Save Changes first.
Green means active, red means banned, and yellow means any other status.
If the label does not match what you expect, refresh the page to see the latest saved state.