Page MenuHomePhabricator

icons: Add [Saved] 'bookmarkList' icon to Codex
Closed, ResolvedPublic1 Estimated Story Points

Assigned To
Authored By
Sneha
Jul 31 2025, 10:00 PM
Referenced Files
F65803685: BookmarkList-rtl.svg
Aug 20 2025, 6:31 PM
F65756626: BookmarkList.svg
Aug 15 2025, 4:23 PM
F65756640: BookmarkList.png
Aug 15 2025, 4:23 PM
F65698738: Saved item in menu.png
Jul 31 2025, 10:03 PM
F65698727: Saved item in menu.png
Jul 31 2025, 10:00 PM
F65698717: saved icon.png
Jul 31 2025, 10:00 PM
F65698687: bookmark icon.png
Jul 31 2025, 10:00 PM
F65698675: App.PNG
Jul 31 2025, 10:00 PM

Description

Background

As part of this ticket T400946 and the Reading list experiment on web we need an icon that would allow users to access their saved list of articles.

Known use case(s):
Currently the apps use "cdxIconBookmark" icon in the tabs to access saved list of articles as shown below:

App.PNG (2×1 px, 1 MB)

However, this icon cannot be used on web due to having the bookmark icon also visible above articles (to save articles), which would result in two bookmark icons on the same screen as shown below:

bookmark icon.png (496×942 px, 40 KB)

And so the proposal is to create a new icon to access saved list on web similar to watchlist icon "cdxIconWatchlist" but with a bookmark instead of star as shown below:

saved icon.png (608×1 px, 45 KB)
Saved item in menu.png (534×600 px, 178 KB)

Considerations: Will this icon be distinguishable from watchlist icon at certain sizes.

User stories

As a designer, I need an icon that we can use on web to access saved content

Open questions

  • Will the proposed icon be too similar to watchlist at a certain size? Yes, We made edits to the bookmark icon and the list line width to further differentiate it from the watch list icon.
  • Are there other options we can explore? Yes, other options were explored however we decided to stick to the icon style we have for other user lists like "watchlist" and "contributions" and come back to revising if needed as part of the larger icon consistency project that @DTorsani-WMF is working on.

Design proposal

The design of this icon is inspired by other existing user list icons such as "watchlist" and "contributions" on Web. We decided to not use the Bookmark icon (used by apps) to access saved list on web because the Bookmark icon is used as an action to save the article in very close proximity to where the BookmarkList icon may appear and may cause user confusion. In the future, we plan to align the icons across platforms but for now we decided to go with the following design.

BookmarkList.png (20×20 px, 253 B)

SVG icon

Once the icon has been created, we will export it in SVG format and add it here.


Acceptance criteria for Done

Design

  • The design of the new icon is ready, and it follows the icon guidelines
    • An RTL icon has been created (if needed)
    • The icon is recognizable on low DPI resolutions
    • The icon has been exported as an optimized SVG and added to this task’s description
    • The new icon has been included and published in the Codex Figma library

Code

  • Add icon in Codex
  • Add icon in OOUI

Documentation

Event Timeline

Sneha updated the task description. (Show Details)
Sneha added a subscriber: DTorsani-WMF.

Change #1179764 had a related patch set uploaded (by VolkerE; author: VolkerE):

[design/codex@main] icons: Add 'bookmarkList' icon

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

Change #1179764 merged by jenkins-bot:

[design/codex@main] icons: Add 'bookmarkList' icon

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

@Volker_E For adding the icon to OOUI, is there some particular tool or way that we handle flipping the icon to create the rtl version of the SVG? do we use svgo? or manually flip it and generate the rtl icon?

for optimizing, is it:

npm run minify:svg:src

or anything else?

I see documentation for adding icons to codex but can't find any documentation about this for OOUI.

@aude I can't answer your question but I have added the rtl svg here as @Volker_E had suggested I include that svg in task description here.

Thanks for looking into it @aude! Very helpful. Answers inline.

@Volker_E For adding the icon to OOUI, is there some particular tool or way that we handle flipping the icon to create the rtl version of the SVG? do we use svgo? or manually flip it and generate the rtl icon?

for optimizing, is it:

npm run minify:svg:src

or anything else?

That's the right command. Additionally SVGO (one of my fav tools online) could help as you have direct visual comparison. What works most of the time without visual impact is reducing number precision to 1 or 2 on this canvas size with the icon own details.

I see documentation for adding icons to codex but can't find any documentation about this for OOUI.

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

[oojs/ui@master] icons: Add 'bookmarkList' icon

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

@Volker_E will we need to do a release of OOUI? and update usage in MediaWiki core, vendor and VisualEditor?

see release section of the documentation:

https://doc.wikimedia.org/oojs-ui/master/js/

Volker_E renamed this task from [Saved]: Add [Saved] icon to Codex for usage on Web to [Saved]: Add [Saved] 'bookmarkList' icon to Codex for usage on Web.Aug 21 2025, 7:01 PM
Volker_E updated the task description. (Show Details)
Volker_E updated Other Assignee, added: aude.

Change #1180857 merged by jenkins-bot:

[oojs/ui@master] icons: Add 'bookmarkList' icon

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

Change #1180982 had a related patch set uploaded (by LorenMora; author: LorenMora):

[mediawiki/core@master] Update Codex from v2.2.1 to v2.3.1

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

Test wiki created on Patch demo by LMora-WMF using patch(es) linked to this task:
https://590db65713.catalyst.wmcloud.org/w/

Change #1180982 merged by jenkins-bot:

[mediawiki/core@master] Update Codex from v2.2.1 to v2.3.1

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

Volker_E updated the task description. (Show Details)

Test wiki on Patch demo by LMora-WMF using patch(es) linked to this task was deleted:

https://590db65713.catalyst.wmcloud.org/w/

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

[mediawiki/core@master] Update OOUI to v0.53.0

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

Change #1184603 merged by jenkins-bot:

[mediawiki/core@master] Update OOUI to v0.53.0

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

Change #1188395 had a related patch set uploaded (by Thiemo Kreuz (WMDE); author: Thiemo Kreuz (WMDE)):

[design/codex@main] icons: Optimize and fix 'bookmarkList' icon

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

Change #1188395 merged by jenkins-bot:

[design/codex@main] icons: Optimize and fix 'bookmarkList' icon

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

Change #1191541 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/core@master] Update Codex from v2.3.1 to v2.3.2

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

Change #1191541 merged by jenkins-bot:

[mediawiki/core@master] Update Codex from v2.3.1 to v2.3.2

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

Volker_E renamed this task from [Saved]: Add [Saved] 'bookmarkList' icon to Codex for usage on Web to icons: Add [Saved] 'bookmarkList' icon to Codex.Sep 29 2025, 5:40 PM