Update your settings
Use Your Settings to change the personal details held on your profile: your profile-picture URL, username, bio, email address, and optional password. After a successful update, the app takes you to the profile for the submitted username.
| If you need to… | Go to |
|---|---|
| See what each setting does | Review the settings fields |
| Change your personal details | Update your settings |
| Handle an optional password or sign-in branch | Handle optional password and sign-in branches |
| Resolve an update error | When an update goes wrong |
| Continue to your profile after saving | View a profile |
| Read the general error messages | General error messages |
Before you start
You must be signed in before you can open the settings screen. The form loads your current username, email, bio, and profile-picture URL when the screen opens. Your password is not loaded into the form.
Prerequisites
- Have an authenticated account.
- Have the new values ready for any details you want to change.
If you open the settings route while signed out, the app sends you to the sign-in route.
Open Your Settings
Open the settings screen
Prerequisites
- You are signed in.
Steps
- Open
/settings.
Result: The Your Settings screen opens with the settings form.
Review the settings fields
The settings form contains five personal details that you can review before submitting a change. The prompts appear inside the fields rather than as separate visible field labels.
| Field | What to enter |
|---|---|
| URL of profile picture | The URL for the profile picture you want to use. |
| Your username | The username you want associated with the profile. |
| Short bio about you | A short description about you. |
| Your email address. | |
| Password | A new password when you want to change it. |
None of the five fields has a required marker. Password starts empty rather than being copied from your current account.
Update your settings
Change the details you want to store, then submit the form. The update sends the username, email, bio, and profile-picture URL. It sends a password only when you enter one.
Prerequisites
- You are signed in and the settings form is open.
Steps
-
Enter the new value in the relevant field.
-
Choose the password handling that matches your change in Password:
If you need to… In Password Keep your current password Leave the field empty. Change your password Enter the new value. -
Select Update Settings.
Result: The app clears the current error list and routes you to the profile for the submitted username.
Handle optional password and sign-in branches
The Password choice determines whether a password is included in the update. Sign-in controls whether the settings screen opens.
Prerequisites
- Decide whether you are changing the password.
Steps
-
Choose the path that matches your situation:
If you need to… Do this Keep your current password Leave Password empty, then continue with the other settings. Change your password Enter the new value in Password, then continue with the other settings. Open settings while signed out Sign in when the app sends you to the sign-in route.
Result: An empty Password is omitted from the update, an entered password is included, and a signed-out attempt is sent to sign-in.
When an update goes wrong
The error list displays the values returned when an update produces errors. A network failure uses
the message Unable to connect to the server.
Prerequisites
- The settings form is open.
- You have entered the values you want to submit.
Steps
-
Select Update Settings.
-
Read the message shown in the error list:
Message Where it appears A server-provided error value The error list. Unable to connect to the serverThe error list.
Result: The error list displays the server-provided error value or
Unable to connect to the server.
Leave Settings
After you submit a successful update, the app takes you to the profile for the submitted username. You can also sign out from the settings screen.
Prerequisites
- The settings screen is open.
Steps
-
Choose the path that matches what you want to do:
If you need to… Select Continue with the updated profile Select Update Settings, then continue from the submitted username's profile. End your signed-in session Select Or click here to logout.
Result: A successful update takes you to the submitted username's profile. Logging out clears the signed-in session and takes you to home.
Was this page helpful?