> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terminus.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Profile settings

> Update your display name, the email you sign in with, and your password from your own profile settings page.

<Info>
  Your profile settings cover the three things that belong to you, not your account: your display name, the email you sign in with, and your password. Open them from the user menu at the bottom of the sidebar, then choose **Profile Settings**. Every signed-in user has this page, whatever their role.
</Info>

## Where to find it

The profile settings page is reached from the user menu, not from the admin area.

<Steps>
  <Step title="Open the user menu">
    Click your avatar at the bottom of the sidebar.
  </Step>

  <Step title="Choose Profile Settings">
    The page opens with a single **Profile settings** card. Each setting shows as a row with its current value and an **Edit** button.
  </Step>
</Steps>

You can edit one row at a time. Opening a row to edit closes any other open row, and **Cancel** returns you to the read-only view without saving.

## What you can change

The card has up to three rows.

| Setting      | What you change                                               | When it takes effect                           |
| ------------ | ------------------------------------------------------------- | ---------------------------------------------- |
| **Name**     | The display name shown in the sidebar and across the app.     | Right away.                                    |
| **Email**    | The address you sign in with. Requires your current password. | After you confirm the new address (see below). |
| **Password** | Your sign-in password. Requires your current password.        | Right away.                                    |

Name is the only profile field you can edit. There is no avatar, no separate first and last name, and no locale, timezone, or other profile attribute to set here.

### Change your name

Click **Edit** on the **Name** row, type the new name, and save. **Save** is available once the name is non-empty and different from the current one. On success you see a "Name updated." confirmation and the name in the sidebar refreshes immediately.

### Change the email you sign in with

Changing your email is a two-step flow. It does not switch over the moment you save.

<Steps>
  <Step title="Enter the new email and your current password">
    Click **Edit** on the **Email** row. Type the **New email** and your **Current password** (this confirms it is really you), then choose **Update email**.
  </Step>

  <Step title="Confirm the new address">
    Click the confirmation link sent to the new address. Until you do, you keep signing in with your old email.
  </Step>
</Steps>

While a change is awaiting confirmation, the **Email** row shows a **Pending** badge and the line "Awaiting confirmation at" followed by the new address, so you can see exactly what you are confirming.

Two emails go out when you start the change: a confirmation link to the **new** address, and a security notice to your **current** address letting you know an email change was requested. The notice to your old address is there so you notice a change you did not make.

<Warning>
  Saving an email change does not update your sign-in email on its own. The new address only becomes active after you click the confirmation link sent to it. Until then, your old email keeps working.
</Warning>

### Change your password

Click **Edit** on the **Password** row, enter your **Current password** and a **New password**, then choose **Change password**. The change takes effect right away, and a confirmation email is sent to you. If the new password is too short, an error appears next to the field; pick a longer one and try again.

## If you sign in through SSO

When your account is linked to a single sign-on (SSO) identity provider, some settings are managed for you and cannot be changed here.

* **Email is locked.** The **Email** row has no **Edit** button, and hovering it shows "Your email is managed by your identity provider." Your provider re-syncs your email each time you sign in, so an in-app change would not stick.
* **The Password row is hidden.** You sign in through your provider, so there is no in-app password to change.
* **Name is still editable.** You can update your display name as usual. If your provider sends a name, it may re-sync on your next sign-in.

See [Authentication](/authentication) for more on SSO and signing in.

## Gotchas

* **Email changes are not instant.** Your sign-in email stays the same until you click the confirmation link sent to the new address. If you "changed" your email but still sign in with the old one, the new address has not been confirmed yet, so check the new inbox for the link.
* **An email change sends two emails; a password change sends one.** Changing your email notifies both the new address (the confirmation link) and your old address (a security notice). Changing your password sends one confirmation to you.
* **Both email and password require your current password.** This confirms your identity before either changes.
* **Name is the only editable profile field.** Avatars, separate name parts, locale, and timezone do not exist on this page.
* **SSO accounts cannot change email or password here.** Those controls are hidden or blocked because your identity provider owns them. Name remains editable.

## Related

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    How signing in works, including SSO and confirming an email change.
  </Card>

  <Card title="Account overview" icon="building" href="/account/overview">
    Account-level settings, separate from your personal profile.
  </Card>
</CardGroup>
