Personalizing your workspace
Your settings page is where you review and update your personal profile details. It contains fields for your profile picture URL, username, short bio, email, and a new password.
| If you need to… | Go to |
|---|---|
| Open the settings page | Open your settings |
| Check which profile values you can change | Review your profile fields |
| Submit changed profile values | Update your profile settings |
| Understand a successful or failed save | Handle the save outcomes |
| Read a returned error | When the update does not go through |
| Find broader settings guidance | Manage your settings |
| Find general error-message guidance | General error messages |
Before you start
The settings page works with the signed-in user's profile values. The current user is the signed-in user whose profile values appear in the form. Have the values you want to review or change ready before you begin.
Prerequisites
- Be signed in so the page can receive the current user's profile values.
- Know whether you want to change the profile picture URL, username, short bio, email, or password.
- Open the settings route at
/settings.
Open your settings
The settings page is the personal profile surface at /settings, separate from article and profile
routes.
Prerequisites
- Be signed in.
Steps
- Open
/settingsin the application.
Result: The settings page opens with the heading Your Settings, the profile fields, the Update Settings button, and the Or click here to logout. button.
Review your profile fields
Use the table below to identify each input before changing it.
| Field | Type | What appears initially |
|---|---|---|
| URL of profile picture | Text input | The current profile-picture URL, or an empty value when no image is present |
| Username | Text input | The current username |
| Short bio about you | Text area with eight rows | The current bio |
| Email input | The current email | |
| New Password | Password input | An empty value |
The first four fields receive values from the current user when the form loads or when a new current user is received. The profile-picture field uses an empty value when the current user has no image. None of the five fields has a required marker in the form.
Update your profile settings
Use this procedure when you want to change one or more personal profile values.
Prerequisites
- Be on
/settings. - Know the values you want to enter.
Steps
-
Enter the new value in the field you want to change:
If you want to change… Enter the new value in… Your profile-picture URL URL of profile picture Your username Username Your short description Short bio about you Your email address Email Your password New Password -
Select Update Settings.
If you leave New Password empty, the submitted update leaves the password out. The settings request sends the values to the user update endpoint.
Result: The application processes the settings update.
Handle the save outcomes
The save outcome tells you whether the application accepted the profile update or returned errors.
| What happens | What you see next |
|---|---|
| The update is in progress | Update Settings is disabled while processing |
| The update succeeds | The current user is replaced and the application redirects to / |
| The update fails | The settings errors are stored and the redirect target remains empty |
| Errors are available | The error area lists each returned error key and value |
Result: A successful update takes you to /; a failed update keeps the settings page available for
correction.
When the update does not go through
Returned settings errors appear above the form in the error area. Each item combines the returned error key and value, so use the text shown there to decide what to correct before selecting Update Settings again.
| What you see | What to do |
|---|---|
| A returned error item above the form | Read the key and value, correct the related profile field, and select Update Settings again |
| No returned error item | Continue with the result shown after the update |
After updating your settings
After a successful update, the application replaces the current user and redirects to /.
If you want to leave the settings page without submitting another change, select Or click here to logout.
Prerequisites
- Be on the settings page.
Steps
- Select Or click here to logout.
Result: The application clears the current user and redirects to /.
Was this page helpful?