# Manage your settings

## Manage your account settings

Settings is the signed-in account page for reviewing and updating your profile details.
Conduit places account updates and logout on this page; account creation belongs to the sign-up
page.

| If you need to… | Go to |
|---|---|
| Prepare to use account settings | [Before you start](#before-you-start) |
| Open the account settings page | [Open Settings](#open-settings) |
| Identify the profile fields and controls | [Understand the Settings screen](#understand-the-settings-screen) |
| Change your profile details | [Update your account details](#update-your-account-details) |
| End your signed-in session | [Log out from Settings](#log-out-from-settings) |
| Handle an empty password or returned error | [Handle settings branches and errors](#handle-settings-branches-and-errors) |
| Sign in | [Sign in](doc:sign-in) |
| Create an account | [Sign up](doc:sign-up) |
| Personalize profile details | [Personalizing your workspace](doc:personalizing-your-workspace) |
| Follow the broader first-day path | [Your first day](doc:your-first-day) |

## Before you start

Settings works with the profile values belonging to the signed-in account. The page receives those
values when the current account is available, so sign in before opening Settings and have the
details you want to review or change ready.

**Prerequisites**

- Be signed in.
- Have the profile details you want to review or change ready.
- Know whether you want to change the profile picture URL, username, short bio, email, or password.

## Open Settings

The Settings route is `/settings`, and a signed-in header contains the **Settings** link.

**Prerequisites**

- Be signed in.

**Steps**

1. Select **Settings** in the application header.

**Result:** The application opens `/settings`.

## Understand the Settings screen

The Settings screen contains five profile fields, an update control, an error area, and a logout
control.

| Field | Type | Use it to… |
|---|---|---|
| **URL of profile picture** | Text input | Enter the address of the profile picture. |
| **Username** | Text input | Enter the account username. |
| **Short bio about you** | Text area with eight rows | Enter a short profile description. |
| **Email** | Email input | Enter the account email address. |
| **New Password** | Password input | Enter a replacement password. |

The form also contains **Update Settings** and **Or click here to logout.**. Returned settings
errors appear in the error area above the form. While an update is in progress, **Update Settings**
is disabled.

## Update your account details

Use this procedure to change one or more profile details on the Settings page.

**Prerequisites**

- Be on `/settings`.
- Have the values you want to enter ready.

**Steps**

1. Enter the value you want to change:

   | If you want to change… | Enter it in… |
   |---|---|
   | Your profile-picture address | **URL of profile picture** |
   | Your account name | **Username** |
   | Your profile description | **Short bio about you** |
   | Your account email address | **Email** |
   | Your replacement password | **New Password** |

2. Select **Update Settings**.

If **New Password** is empty, the update omits the password. The form sends the values to save your
account details.

**Result:** **Update Settings** submits your changed account details.

## Log out from Settings

The logout control ends the signed-in account session from the Settings page.

**Prerequisites**

- Be on the Settings page.

**Steps**

1. Select **Or click here to logout.**.

**Result:** The signed-in session ends.

## Handle settings branches and errors

The form handles two cases: an empty **New Password** is omitted from the submitted update, and
**Update Settings** is disabled while the update is in progress.

**Prerequisites**

- Be on the Settings page.

**Steps**

1. Choose the case that matches what you see:

| If you see… | Do this |
|---|---|
| **Update Settings** is disabled | Wait for the current update to finish before selecting it again. |
| You want to keep the current password | Leave **New Password** empty, then select **Update Settings**. |
| A returned error appears above the form | Read the returned key and value, correct the related field, and select **Update Settings** again. |

Each returned error appears as its key followed by its value.

“No fixed message; each rendered item is `key` followed by `errors[key]`.”

**Result:** The form responds to the in-progress update, empty password, or returned error.

## After Settings

After you select **Update Settings** or **Or click here to logout.**, use [Sign in](doc:sign-in) to
start a signed-in session or [Sign up](doc:sign-up) to create an account when either task applies.

**Result:** You know where to continue for sign-in or account creation.