Page MenuHomePhabricator

When user saves their first ReadingList page, the bookmarkList icon links user to the Special:ReadingLists parent page instead of the default list.
Closed, ResolvedPublic2 Estimated Story PointsBUG REPORT

Description

Steps to replicate the issue (include links if applicable):

  • Create a new user and have this user opt-in to the ReadingLists beta feature
  • Then save a page to the reading list (the user's first page)

What happens?:

  • Hover over the bookmark list icon in the personal tools to see that the url is to Special:ReadingLists and not the default reading list (SpecialPage subpage)

Screenshot 2025-10-31 at 7.41.39 AM.png (965×1 px, 129 KB)

This happens because when loading the page, the user is not setup yet with a default reading list. In this situation, the code sets the url to the parent special page (Special:ReadingLists) rather than to the default reading list subpage.

For subsequent page loads, the url for the bookmark list icon will work correctly, but we will have the onboarding "saved pages" dialog to highlight the bookmarklist icon after the first save. It would be a bad user experience if the link does not take them to the default list.

What should have happened instead?:

Clicking the bookmark list icon should take the user their their default list (if they have one).

  • One possible solution could be to use JavaScript to update the bookmark list icon url after the user saves a page to their reading list.
  • Another solution could be to have the bookmark list icon to link to Special:ReadingLists/{username}/default and then have the special page handle a redirect to the default list if one exists for the user. I think this would be the better solution.

Software version (on Special:Version page; skip for WMF-hosted wikis like Wikipedia):

Other information (browser name/version, screenshots, etc.):

Requirement

Scope: ReadingLists (desktop + mobile).

  • When a user saves their first article to their Reading List, the “bookmark list” icon in the personal tools menu must link directly to their default Reading List subpage instead of the parent page (Special:ReadingLists).
  • This fix applies to users who have just created their default Reading List after saving their first page.
  • The link should always point to Special:ReadingLists/{username}/default, and the backend should handle redirection if the list does not yet exist.
  • For users without any saved items, the behavior should remain unchanged until the first save action.
  • The fix should work immediately after the first save without requiring a page reload.

BDD

Feature: Bookmark list icon links to default Reading List

  Scenario: User saves their first article
    Given I am a logged-in user who has just opted into Reading Lists
    And I have no saved articles yet
    When I save my first article
    Then the bookmark list icon updates to link to `Special:ReadingLists/{username}/default`
    And clicking it takes me to my default Reading List page

  Scenario: User with existing Reading List
    Given I already have saved articles in my Reading List
    When I visit any article page
    Then the bookmark list icon link continues to point to my default list

Test Steps

Test Case 1: Verify correct link after first save

  1. Create a new account and enable the ReadingLists beta feature.
  2. Confirm that before saving, the bookmark list icon URL points to Special:ReadingLists.
  3. Save the first article using the bookmark icon.
  4. AC1: The bookmark list icon link updates to Special:ReadingLists/{username}/default.
  5. AC2: Clicking the icon navigates to the user’s default Reading List page.
  6. AC3: The update occurs without requiring a page reload.

Test Case 2: Verify existing user behavior

  1. Log in as a user with one or more saved Reading List items.
  2. Hover over the bookmark list icon.
  3. AC4: The icon link continues to point to Special:ReadingLists/{username}/default.
  4. AC5: Clicking the icon opens the correct default Reading List.

QA Results - Beta

Event Timeline

aude triaged this task as High priority.Nov 3 2025, 5:35 PM
aude moved this task from Incoming to Needs refinement on the Reader Experience Team board.
aude set the point value for this task to 2.Nov 4 2025, 5:37 PM
aude moved this task from Needs refinement to Ready for sprint on the Reader Experience Team board.
Volker_E subscribed.

I'd see the second option also as preferable.

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

[mediawiki/extensions/ReadingLists@master] Fix bookmarkList link for new ReadingList users

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

Adding the special page redirect could be more complicated than updating the bookmarkList url after list setup (when user saves their first page). We would need to consider replication lag issues if a user saves their first page and then immediately visits the Special Page.

SToyofuku-WMF lowered the priority of this task from High to Medium.

Lowering the priority as we're not considering this the worst case if it doesn't make the launch - that said, Steph to review and @Jdlrobson-WMF to co-review

Change #1202757 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Fix bookmarkList link for new ReadingList users

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

Edtadros subscribed.

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 correct link after first save

  1. Create a new account and enable the ReadingLists beta feature.
  2. Navigate to an article..
  3. Save the first article using the bookmark icon.
  4. AC1: The bookmark list icon link updates to Special:ReadingLists/{username}/default.

screenshot 23.mov.gif (872×1 px, 1 MB)

  1. AC2: Clicking the icon navigates to the user’s default Reading List page.
  2. AC3: The update occurs without requiring a page reload.

screenshot 24.mov.gif (872×1 px, 586 KB)

Test Case 2: Verify existing user behavior

  1. Log in as a user with one or more saved Reading List items.
  2. Hover over the bookmark list icon.
  3. AC4: The icon link continues to point to Special:ReadingLists/{username}/default.
  4. AC5: Clicking the icon opens the correct default Reading List.

screenshot 26.mov.gif (872×1 px, 654 KB)

Edtadros updated the task description. (Show Details)
HFan-WMF claimed this task.