Skip to main content

App > Design > Self Service > Reset Password

Configure the self-service password reset page for end-users

Written by Jason Liang

The Self Service > Reset Password page configures the hosted page your end-users land on when they click a password reset link. This feature is always enabled — there is no on/off toggle. The reset link itself is generated by calling the brainCloud ResetEmailPasswordAdvancedWithExpiry (or equivalent) API from your app, which sends an email containing a tokenised URL pointing to this hosted page.

All visual branding (header, colours, footer) is inherited from Self Service > Branding. Configure Branding before setting up this page.

The settings panel is always on the left; the live preview on the right updates in real time as you make changes. Toggle the mobile/desktop switch in the preview to check both layouts.

Page 1/1 — Password Reset Form

This is the main page the user lands on after clicking the reset link in their email. The page automatically validates the token from the URL. If the token is valid, it displays a password reset form where the user enters and confirms their new password.

What the user sees:

  • A New Password input field.

  • A Confirm New Password input field.

  • Real-time password strength indicators that reflect the password policy configured for your app (minimum length, required digits, uppercase letters, lowercase letters, and symbols). Each requirement is shown as a visual checklist that updates as the user types.

  • A Reset Password action button that submits the new password once all requirements are met.

  • Any optional navigation buttons you have enabled (see below).

Optional navigation buttons — you can show or hide each of these on Page 1/1. The URL destinations must be configured in Branding > Optional Details first:

  • Show Homepage button — adds a button linking to your app's homepage. When enabled, you can override the label (up to 25 characters); the default is Go to Homepage.

  • Show Feedback button — adds a button linking to your feedback URL. Custom label supported (default: Provide Feedback).

  • Show Exit Survey button — adds a button linking to your exit survey URL. Custom label supported (default: Exit Survey).

  • Show Boilerplate footer * — displays the contact and legal footer from Branding, including your address, Terms & Conditions, and Privacy Policy links. Recommended for compliance.

* Recommended

Result Page

Shown to the user immediately after their password has been successfully reset. The page confirms the action is complete and invites the user to return to your app. Only the Show Boilerplate footer toggle is configurable for this page — the rest of the content (success message, icon) is fixed.

Use the Result Page preview sub-tab to verify the footer appears as expected.

Error Page

Shown when the password reset cannot be completed. Common causes include:

  • The reset link token has already been used.

  • The reset link has expired (token lifetime is configured in your app's authentication settings).

  • A server-side error occurred during processing.

Only the Show Boilerplate footer toggle is configurable for this page. The error message itself is system-generated.

Actions

  • Cancel — reverts all unsaved changes to the last saved state.

  • Save — persists all changes. Disabled if nothing has changed or if any button label exceeds 25 characters.

  • Clear — available to super/developer users only. Resets all settings to their defaults.

A warning dialog is shown if you attempt to navigate away with unsaved changes.

Did this answer your question?