Page MenuHomePhabricator

Onboarding dialog for accessing Saved list
Closed, ResolvedPublic3 Estimated Story Points

Description

Background

This ticket is a split from T400366
We agree to split that ticket into three tickets, this is one of them.

User Story

As a logged-in reader, I'd like to know where can I access by Saved items.

Open questions
  • Clarify message to be most concise: "Access all your saved pages from here." vs "Access all your saved pages here." vs …?
Design
  • SVG for illustration to be provided

  • The onboarding dialog informing users about Saved list appears when the user saves their first page
    • The dialog points to where the Save feature is available depending on the width of the screen
  • The onboarding dialog should show on top of the generic confirmation toast (if we cannot hide it for this instance)
  • The onboarding dialog should be exited by clicking the 'x' button or clicking anywhere on the screens.
  • Onboarding dialog is reviewed by the designer
New Vector-1.png (789×1 px, 367 KB)
HEADER-1.png (789×733 px, 252 KB)
When the Saved list is in the header, the onboarding dialog points to the icon in the headerWhen Saved list is under the user menu, the onboarding dialog points to the user menu
Link to Figma

Requirement

Scope: Desktop web (Vector 2022).

  • Display an onboarding dialog informing users how to access their Saved list after saving their first article.
  • The dialog must appear immediately after the first successful save action.
  • The dialog points to the location of the Saved list entry in the user menu or toolbar, depending on viewport width.
  • The dialog appears above the confirmation toast if both are present.
  • The dialog can be dismissed by clicking the close (“x”) button or anywhere outside the dialog.
  • The dialog message should be concise (e.g., “Access all your saved pages from here.”).
  • Onboarding dialog appearance and placement must be reviewed by design.

BDD

Feature: Onboarding dialog for accessing Saved list

  Scenario: Showing onboarding dialog after first saved article
    Given I am a logged-in user
    And I have just saved my first article using the bookmark icon
    When the save action completes
    Then an onboarding dialog appears pointing to the Saved list location
    And the message reads “Access all your saved pages from here.”

  Scenario: Dismissing the onboarding dialog
    Given the onboarding dialog is visible
    When I click the close button or anywhere outside the dialog
    Then the dialog is dismissed
    And it does not reappear on future saves

Test Steps

Test Case 1: Verify onboarding dialog appears after first save

  1. Log in and enable the Reading List feature.
  2. Clear local storage to simulate a first-time user.
  3. Open an article and click the bookmark icon to save it.
  4. AC1: The onboarding dialog appears immediately after saving the first article.
  5. AC2: The dialog points to the Saved list location in the toolbar or user menu.
  6. AC3: The message reads “Access all your saved pages from here.”
  7. AC4: The dialog appears above the confirmation toast.

Test Case 2: Verify dismissal behavior

  1. Click outside the dialog or click the close (“x”) button.
  2. Save another article.
  3. AC5: The onboarding dialog does not appear again.

QA Results - Beta

QA Results - Prod

Event Timeline

Sneha triaged this task as High priority.Oct 9 2025, 8:11 PM
Jdlrobson-WMF lowered the priority of this task from High to Medium.Oct 15 2025, 5:55 PM

The dialog would overlap with the notification and seems to duplicate functionality that we already have.

Screenshot 2025-10-24 at 10.44.43 AM.png (1×2 px, 719 KB)

Do we really need this additional dialog? and if so, how do we want to handle overlap or the fact that we also have the notifications when a user saves a page.

The point was that this one makes it more clear how to navigate to your saved pages without having to save something else to get the popup - we were hoping the dialogue would overlap on top of the ephemeral notification and cover it entirely, but if that's not the case we might want to figure out how to hack it if possible

Change #1198595 had a related patch set uploaded (by Aude; author: Aude):

[mediawiki/extensions/ReadingLists@master] WIP - Add onboarding dialog for accessing "saved list"

https://gerrit.wikimedia.org/r/1198595

For the copy, I suggest something more concise:

Access all your saved pages here.

SToyofuku-WMF added a subscriber: aude.
SToyofuku-WMF raised the priority of this task from Medium to High.Oct 30 2025, 4:18 PM

Bringing this back up to high as I believe it was only medium in the context of last sprint

Also @Volker_E are you still taking a look at this or does it need another asignee?

Volker will try to review, and Steph will also try to review

Change #1198595 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Add onboarding dialog for accessing "saved list"

https://gerrit.wikimedia.org/r/1198595

Volker and Steph both reviewed!!

Edtadros subscribed.

Test Result - Prod

Status: ✅ PASS
Environment: testwiki
OS: macOS Tahoe 26.x
Browser: Chrome Canary (latest as of test date)
Device: MS
Emulated Device: NA

Test Case 1: Verify onboarding dialog appears after first save

  1. Log in and enable the Reading List feature.
  2. Clear local storage to simulate a first-time user.
  3. Open an article and click the bookmark icon to save it.
  4. AC1: The onboarding dialog appears immediately after saving the first article.
  5. AC2: The dialog points to the Saved list location in the toolbar or user menu.
  6. AC3: The message reads “Access all your saved pages from here.”
  7. AC4: The dialog appears above the confirmation toast.

screenshot 9.mov.gif (868×1 px, 917 KB)

Test Case 2: Verify dismissal behavior

  1. Click outside the dialog or click the close (“x”) button.
  2. Save another article.
  3. AC5: The onboarding dialog does not appear again.

screenshot 10.mov.gif (868×1 px, 704 KB)

Test Result - Beta

Status: ✅ PASS
Environment: beta
OS: macOS Tahoe 26.x
Browser: Chrome Canary (latest as of test date)
Device: MS
Emulated Device: NA

Test Case 1: Verify onboarding dialog appears after first save

  1. Log in and enable the Reading List feature.
  2. Clear local storage to simulate a first-time user.
  3. Open an article and click the bookmark icon to save it.
  4. AC1: The onboarding dialog appears immediately after saving the first article.
  5. AC2: The dialog points to the Saved list location in the toolbar or user menu.
  6. AC3: The message reads “Access all your saved pages from here.”
  7. AC4: The dialog appears above the confirmation toast.

screenshot 11.mov.gif (908×1 px, 1 MB)

Test Case 2: Verify dismissal behavior

  1. Click outside the dialog or click the close (“x”) button.
  2. Save another article.
  3. AC5: The onboarding dialog does not appear again.

See AC4

HFan-WMF claimed this task.