[Mobile Reading list] Notify users of the Reading List feature
Closed, ResolvedPublic3 Estimated Story Points
Actions

Assigned To

Authored By

	Sneha
	Nov 11 2025, 6:52 PM

Project Tags

Referenced Files

	F72798536: Screenshot 2026-03-10 at 6.28.55 PM.png
	Mar 10 2026, 10:36 PM

	F72798533: Screenshot 2026-03-10 at 6.28.42 PM.png
	Mar 10 2026, 10:36 PM

	F72798515: Screenshot 2026-03-10 at 6.27.22 PM.png
	Mar 10 2026, 10:36 PM

	F72798512: Screenshot 2026-03-10 at 6.27.09 PM.png
	Mar 10 2026, 10:36 PM

	F72625706: Screenshot 2026-03-05 at 3.34.52 PM.png
	Mar 5 2026, 8:44 PM

	F70318958: Article.png
	Nov 21 2025, 7:43 PM

	F70318952: Article.png
	Nov 21 2025, 7:43 PM

	F70316308: Article.png
	Nov 21 2025, 3:09 PM

Subscribers

Description

T409861 and T409865 are is prerequisite for this ticket

Background

As part of introducing Reading list on mobile web, we would like to draw people's attention to the feature the first time they encounter it.

User story

As a logged-in reader, I'd like to be notified about the new Reading List feature only once

Design

Dialog pointing to Save icon	Dialog pointing to user menu

CTA on tablet is adjusted to not be full width

Screenshot 2026-03-05 at 3.34.52 PM.png (1,684×1,362 px, 188 KB)

Link to Figma

Requirements

The first onboarding dialog points to Save icon
The second onboarding dialog points to user menu after the user saves the first item, to inform them where they can find it later.

For both dialogs:

The onboarding dialogs should only ever be showed once for users
The onboarding dialog only appears when the Save icon or User Menu is visible on the screen
The dialog can be dismissed by tapping on "Ok" or tapping outside the the dialog
Ensure we do not add a performance burden for all users (e.g. load the entirety of Codex on page load)

Note: The onboarding dialog on mobile are intentionally different from the the Desktop one. Implementing the mobile version should not affect the Desktop dialogs.

Technical Notes

Reference T400366 - Desktop implementation

Details

Related Changes in Gerrit:

Subject	Author	Repo	Branch	Lines +/-
Add "Saved pages" popover for Minerva after first page saved	Aude	mediawiki/extensions/ReadingLists	master	+64 -37
Split onboarding popover into skin-specific resource loader modules	Aude	mediawiki/extensions/ReadingLists	master	+258 -130
Mobile notification popover for ReadingLists	Aude	mediawiki/extensions/ReadingLists	master	+282 -19
Add tests for the OnboardingPopover	Aude	mediawiki/extensions/ReadingLists	master	+201 -3

Customize query in gerrit

Related Objects

Mentioned Here: T400366: [Reading List] Notify users of new Reading List feature when experiment launches (onboarding)
T409861: [Tracking epic][Mobile Reading List] A way for users to save article
T409865: [Mobile Reading list] QA Access reading list from user menu

Event Timeline

Sneha created this task.Nov 11 2025, 6:52 PM

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptNov 11 2025, 6:52 PM

HFan-WMF triaged this task as High priority.Nov 17 2025, 4:08 PM

HFan-WMF added a project: FY252627 Reading Lists.

HFan-WMF moved this task from Incoming to Phase 2 Beta feature launch (+ mobile web improvements) on the FY252627 Reading Lists board.

Sneha raised the priority of this task from High to Needs Triage.Nov 19 2025, 6:50 PM

Sneha triaged this task as High priority.

Sneha moved this task from Backlog to Needs refinement on the Reader Experience Team board.

Sneha moved this task from Needs refinement to Backlog on the Reader Experience Team board.

Sneha raised the priority of this task from High to Needs Triage.Nov 21 2025, 3:09 PM

Sneha updated the task description. (Show Details)

Sneha moved this task from Backlog to Needs refinement on the Reader Experience Team board.

Sneha updated the task description. (Show Details)Nov 21 2025, 7:43 PM

bwang triaged this task as High priority.Nov 24 2025, 6:51 PM

Jdlrobson-WMF set the point value for this task to 3.Dec 2 2025, 5:10 PM

Jdlrobson-WMF moved this task from Needs refinement to Ready for sprint on the Reader Experience Team board.Dec 2 2025, 6:45 PM

aude claimed this task.Jan 14 2026, 7:07 PM

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

[mediawiki/extensions/ReadingLists@master] POC - Mobile notification popover for ReadingLists

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

gerritbot added a project: Patch-For-Review.Jan 15 2026, 8:54 PM

HFan-WMF lowered the priority of this task from High to Medium.Feb 10 2026, 6:32 PM

@HFan-WMF I thought about this a bit more. And I think we should make this higher priority. Especially the second dialogue that appears on first save - the access to save pages is inside a menu which may not be discoverable right away so its important we let users know where to find their saved pages when they first save anything. For the other prompt I think at least during the beta phase it will be good to make it as discoverable as possible for accurate assessment of interest in the feature so we can rule out lack of discovery as an issue.

The reason we should not go with pulsating dot right now is that I think to dismiss it you have to tap on the button (or atleast that is my understading) and we don't want to force users to save something they are not interested in saving just to dismiss the dot.

HFan-WMF raised the priority of this task from Medium to High.Feb 11 2026, 7:10 PM

SToyofuku-WMF edited projects, added: Reader Experience Team (REx Sprint 15 [Q3 Feb 24 - Mar 9]); removed: Reader Experience Team.Feb 24 2026, 6:46 PM

aude moved this task from Ready to Needs code review on the Reader Experience Team (REx Sprint 15 [Q3 Feb 24 - Mar 9]) board.Feb 26 2026, 2:16 PM

aude moved this task from Needs code review to In progress on the Reader Experience Team (REx Sprint 15 [Q3 Feb 24 - Mar 9]) board.

Jdrewniak moved this task from Phase 2 Beta feature launch (+ mobile web improvements) to Phase 2 - Beta feature on the FY252627 Reading Lists board.Mar 2 2026, 7:04 PM

Jdrewniak edited projects, added: FY252627 Reading Lists (Phase 2 - Beta feature); removed: FY252627 Reading Lists.

Jdrewniak moved this task from Backlog to Mobile on the FY252627 Reading Lists (Phase 2 - Beta feature) board.Mar 2 2026, 7:33 PM

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

[mediawiki/extensions/ReadingLists@master] Add tests for the OnboardingPopover

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

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

[mediawiki/extensions/ReadingLists@master] Add "Saved pages" popover for Minerva after first page saved

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

aude removed aude as the assignee of this task.Mar 3 2026, 10:03 PM

aude moved this task from In progress to Needs code review on the Reader Experience Team (REx Sprint 15 [Q3 Feb 24 - Mar 9]) board.

aude subscribed.

SToyofuku-WMF assigned this task to aude.Mar 4 2026, 6:11 PM

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

[mediawiki/extensions/ReadingLists@master] Split onboarding popover into skin-specific resource loader modules

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

Change #1247654 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Add tests for the OnboardingPopover

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

Sneha updated the task description. (Show Details)Mar 5 2026, 8:44 PM

ReleaseTaggerBot added a project: MW-1.46-notes (1.46.0-wmf.19; 2026-03-10).Mar 5 2026, 9:00 PM

Change #1219883 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Mobile notification popover for ReadingLists

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

Change #1247686 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Add "Saved pages" popover for Minerva after first page saved

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

Change #1248090 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Split onboarding popover into skin-specific resource loader modules

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

aude removed a project: Patch-For-Review.Mar 6 2026, 10:38 PM

aude moved this task from Needs code review to Needs QA on the Reader Experience Team (REx Sprint 15 [Q3 Feb 24 - Mar 9]) board.

Checked on enwiki beta - looks/behaves as expected.

Design - Dialog pointing to Save icon	`enwiki beta`

Design - Dialog pointing to user menu	`enwiki beta`

Tablet:

Design	`enwiki beta`

@aude, the first h4(?) in the notification has padding enabled, adding too much vertical space on top. We should tackle this for a harmonious layout.

HFan-WMF closed this task as Resolved.Mar 20 2026, 4:17 PM

[Mobile Reading list] Notify users of the Reading List featureClosed, ResolvedPublic3 Estimated Story PointsActions