# Update settings

## Update your settings

The Settings page is where you maintain your own account details after you sign in. Open
**Your Settings** when you need to change your profile picture URL, username, bio, email, or
password. The page is available at `/settings`.

The profile page links your own profile to this task through **Edit Profile Settings**. The
settings page supports creating, reading, and updating user information; it does not provide a
delete operation.

| If you need to… | Go to |
|---|---|
| Open the settings form | [Open Your Settings](#open-your-settings) |
| Identify a field or control | [Understand the Settings screen](#understand-the-settings-screen) |
| Change your account details | [Save your settings](#save-your-settings) |
| Change your password | [Change your password](doc:change-your-password) |
| Sign out | [Sign out](doc:sign-out) |
| Review the profile entry point | [View a profile](doc:view-a-profile) |

## Before you start

Your account settings are personal details associated with the signed-in user. You need to be
signed in before opening the Settings page, and you need the details you want to enter before
you begin.

**Prerequisites**

- You are signed in.
- You have the profile picture URL, username, bio, email, or new password you want to enter.
- You know which details you want to leave unchanged.

The form loads the current user's details when that user is available. The page does not use a
conditional field rule, so the same five settings fields are part of the form.

## Open Your Settings

Use **Edit Profile Settings** from your own profile, or open the authenticated `/settings` route
directly.

**Steps**

1. Choose one entry path:

   | If you need to… | Select or use |
   |---|---|
   | Open settings from your own profile | Select **Edit Profile Settings**. |
   | Open the authenticated route directly | Open `/settings`. |

**Result:** The Settings form opens with the five settings fields and its account controls.

## Understand the Settings screen

The Settings screen is a single form for your profile details and password. Its fields are the
places where you enter the values you want to maintain.

| Field | Use it to… | Input type |
|---|---|---|
| **URL of profile picture** | Enter the address of your profile picture. | Text |
| **Username** | Enter your username. | Text |
| **Short bio about you** | Enter your short biography. | Text area |
| **Email** | Enter your email address. | Email |
| **New Password** | Enter a new password. | Password |

Select **Update Settings** to submit the form. While a submission is in progress, the form
fields are disabled. The page also provides **Or click here to logout.** below the form.

## Save your settings

Change one or more details in **Your Settings** when needed. Leave a detail as it is when you do
not want to change it.

**Prerequisites**

- **Your Settings** is open.
- You know which values to enter.

**Steps**

1. Enter the profile picture address in **URL of profile picture** when you want to change it.
2. Enter the account name in **Username** when you want to change it.
3. Enter your description in **Short bio about you** when you want to change it.
4. Enter your address in **Email** when you want to change it.
5. Enter a new password in **New Password** when you want to change it.
6. Select **Update Settings**.
7. Review the returned user's profile.

The password field is included in the form, but an empty password is removed from the update
request. A successful update uses the returned user information and takes you to that user's
profile.

> **Note:** Leave **New Password** empty when you are not changing the password.

**Result:** Your settings are submitted, and a successful update opens the returned user's
profile.

## Choose an account-maintenance branch

The Settings form includes **New Password**, while the separate **Or click here to logout.**
control handles signing out. Use the branch that matches the task you need to complete.

**Steps**

1. Choose one account-maintenance task:

   | If you need to… | Select or use |
   |---|---|
   | Change the password as its own task | Select [Change your password](doc:change-your-password). |
   | Leave the account signed in and update profile details | Select [Save your settings](#save-your-settings). |
   | End the signed-in session | Select **Or click here to logout.** |

**Result:** You can continue with the account-maintenance task you selected.

## When an update goes wrong

The Settings error list contains the server response for an unsuccessful update.

**Prerequisites**

- **Your Settings** is open.
- You have selected **Update Settings**.

**Steps**

1. Read the item in the error list.
2. Review the error list after the update response finishes.

The screen renders each server error as `<key> <message>` in its error list.

| What you see | What it means | What to do |
|---|---|---|
| An item in the error list | The update response contains a server error. | Read the complete item before trying the update again. |
| The form does not remain available during submission | The form is disabled while the update is in progress. | Wait for the submission to finish before entering another value. |

**Result:** The error item is visible in the error list, and you know to review it before trying
the update again.

## Know what to do next

After a successful settings update, continue from the returned user's profile. To edit those
details again, use **Edit Profile Settings**, which opens `/settings` from your own profile.

If your next task is account security, use [Change your password](doc:change-your-password).
If you are finished with the account, use [Sign out](doc:sign-out).

**Result:** You know whether to continue with the profile, password, or sign-out task.