🏠 Overview › 👥 User Roles ›📖 Complete Onboarding Progress Tracking During First...

Complete Onboarding Progress Tracking During First-Time Org Selection

First-time users who have just authenticated via BankID or Vipps are entering the app for the first time. The onboarding progress indicator (668-onboarding-progress-indicator) visually communicates where organization selection fits in the overall onboarding flow (e.g., Step 2 of 3: Choose your organization). This reduces drop-off during first-time setup by giving users a sense of progress and setting expectations about what comes next. The indicator is only shown during the initial onboarding flow, not on subsequent logins where the user goes directly to the org selection or is auto-redirected based on persisted preference.

MEDIUM story-organization-selection-screen-organization-admin-004 2 pts
2
Story Points
Medium
Priority
Organization Selection Screen
Feature

User Story

As a Organization Administrator
I want to see a clear onboarding progress indicator when I select my organization for the first time
So that I understand how many setup steps remain before I can start using the app and do not feel lost during my first session

Acceptance Criteria

  • Given I am a first-time user who has just completed BankID or Vipps authentication, When the org selection screen appears, Then an onboarding progress indicator is visible showing my current step in the setup flow
  • Given I am a returning user with a previously persisted org selection, When I open the app and reach the org selection screen, Then no onboarding progress indicator is shown
  • Given the onboarding progress indicator is visible, When I select an organization and proceed, Then the indicator updates to reflect completion of this step before navigating forward
  • Given the onboarding progress indicator is displayed, When a screen reader (VoiceOver) reads the screen, Then the progress indicator announces the current step and total steps in accessible text (e.g., 'Step 2 of 3, Choose your organization')

Business Value

All three workshop organizations agreed on incremental rollout and a gentle onboarding experience — users should never feel lost. A progress indicator during first-time organization selection reduces anxiety and abandonment for digitally less-confident users, a population explicitly called out by NHF (stroke survivors) and Blindeforbundet (visually impaired users). Reducing first-session drop-off directly increases the number of active peer mentors in the system, which is the platform's core success metric.

Components

Dependencies

Organization Selection Screen
Related Feature
Organization Administrator
User Role