Migrated portlets: adopt Material Symbols (Rounded) as the sole icon style
Open
@AP2300 is already working on this.
Since Jul 22, 2026.
Team : Modernization
Type : Task
- Dominant language
- Java
- Stars
- 970
- Forks
- 486
- Avg merge
- 3d 33m
- Merged PRs (30d)
- 170
Description
Description
Adopt Material Symbols (Rounded) as the single icon style across every portlet migrated by Modernization. Currently these portlets ship a mix of icon systems (dominated by PrimeIcons pi pi-*), which drifts from the platform-wide design direction and produces an inconsistent UI over time.
Design requirement: Material Symbols Rounded, no exceptions.
Reference: https://fonts.google.com/icons?icon.style=Rounded
Scope
All portlets migrated by Modernization:
dot-tagsdot-query-tooldot-es-searchdot-velocity-playgrounddot-publishing-queuedot-localesdot-categoriesdot-plugins
Acceptance Criteria
- The Material Symbols Rounded font is available application-wide (loaded once at the app shell / global stylesheet if not already present).
- Every icon in the portlets listed above uses
material-symbols-rounded— nopi pi-*(PrimeIcons) references remain in those portlets. - Semantic mapping is preserved when swapping icons, e.g.:
pi-play→play_arrowpi-trash→deletepi-download→downloadpi-upload→uploadpi-chevron-down/pi-chevron-up→keyboard_arrow_down/keyboard_arrow_uppi-exclamation-triangle→warningpi-question-circle→helppi-copy→content_copypi-search→searchpi-times-circle→cancelpi-info-circle→infopi-tags→sellpi-lock→lock
- Where PrimeNG components accept an
iconattribute (buttons,p-inputIcon, file upload triggers, etc.), use the PrimeNG idiom that supports custom icons (iconpTemplateslot, or content projection) so Material Symbols renders correctly inside PrimeNG shells. - Existing accessibility attributes (
aria-label,aria-hidden,[attr.aria-label]) are preserved on each icon element. - Manual QA per portlet: toolbar, table row actions, empty states, dialogs, help/tooltip triggers, error/warning banners — no icon missing or broken.
- Existing
material-symbols-outlinedusages in the codebase (e.g.libs/portlets/edit-ema/ui/) are noted but out of scope for this ticket unless they belong to a listed migrated portlet.
Priority
Medium — design consistency across migrated portlets.
Additional Context
Reference: https://fonts.google.com/icons?icon.style=Rounded
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.