Clearer Onboarding: Step Labels, Page Titles & a Back Button
Clearer Onboarding: Step Labels, Page Titles & a Back Button
Release: v1.0.115
The Problem
The onboarding flow at /onboarding guides new landlords through two steps before they can start submitting quarterly tax returns to HMRC. Until this release, the progress indicator showed only numbered circles — 1 and 2 — with nothing to indicate what those steps actually involved.
This created a few real-world friction points:
Returning users were navigation-blind. If a user started onboarding, closed the browser, and came back later, they'd see two numbered circles with no reminder of what they'd completed or what was left to do.
The auto-redirect felt abrupt. Users who already had an organisation on record were automatically skipped forward to Step 2. Without a label or title to explain the jump, the redirect could feel like an error rather than a helpful shortcut.
Screen reader users had no context. Unlabelled numeric indicators are not meaningful to assistive technologies. A circle containing 2 tells a screen reader user nothing about National Insurance number entry.
What's New in v1.0.115
Step Labels
Each progress circle now has a descriptive label beneath it:
| Circle | Label |
|---|---|
1 | Account Setup |
2 | National Insurance |
These labels are visible at all times during the flow, so users always know where they are and what's coming next — regardless of whether they've been redirected, are returning mid-flow, or are using a screen reader.
Browser Tab Titles
The page <title> tag now reflects the active step:
- Step 1:
Setup — Step 1 of 2 - Step 2:
Setup — Step 2 of 2
Previously the tab showed only the application's default title. The updated titles help users identify the tab when switching between multiple open windows, and provide an additional orientation cue for assistive technology.
Back Button on Step 2
A Back button is now available on Step 2. This lets users return to Step 1 to review or correct their organisation name before completing the National Insurance number entry. Previously, Step 2 had no way to navigate backwards without using the browser's back button, which risked losing entered data.
Who This Affects
- Any landlord going through the onboarding flow for the first time.
- Returning users who started onboarding in a previous session.
- Users auto-redirected to Step 2 because they already have an organisation record (sourced from the AgentOS landlord record import).
- Users relying on screen readers or other assistive technologies.
No Action Required
This is a UI improvement only. No data, settings, or HMRC submission behaviour has changed. Users in the middle of onboarding will see the updated labels immediately on their next visit to /onboarding.