[wp-trac] [WordPress Trac] #65387: Administration: Replace Dashicons icon font with @wordpress/icons SVGs in the admin menu

WordPress Trac noreply at wordpress.org
Mon Jun 1 17:15:25 UTC 2026


#65387: Administration: Replace Dashicons icon font with @wordpress/icons SVGs in
the admin menu
-------------------------------------------------+-------------------------
 Reporter:  lucasmdo                             |      Owner:  (none)
     Type:  enhancement                          |     Status:  new
 Priority:  normal                               |  Milestone:  Awaiting
                                                 |  Review
Component:  Administration                       |    Version:
 Severity:  normal                               |   Keywords:  needs-patch
  Focuses:  ui, accessibility, css, rtl,         |
  administration, performance                    |
-------------------------------------------------+-------------------------
 == Problem / Current Behavior ==

 The admin sidebar menu draws its top-level icons using the Dashicons icon
 font. This is the same legacy approach described in the parent ticket
 #65089, seen here specifically in the left-hand admin navigation.


 == Proposed Enhancement ==

 Replace the Dashicons font icons on Core's '''default''' top-level admin
 menu items with SVG icons from the @wordpress/icons library — the same set
 already used by the editors. The icons keep their current look, position,
 and labels; only the underlying technique changes.

 Worth noting: Core already supports SVG icons for admin menu items (via
 the menu icon API) and already recolors them to match the active color
 scheme (#25147), so the rendering path for SVG menu icons exists today.
 This ticket applies that direction to Core's own default items.

 '''In scope''' — Core's own default top-level menu icons (Dashboard,
 Posts, Media, Pages, Comments, Appearance, Plugins, Users, Tools,
 Settings) and the "Collapse menu" button icon at the bottom of the menu
 (#50423).

 '''Out of scope''':

  * Menu icons added by plugins or themes → see Backward Compatibility.
  * Restructuring or grouping the navigation itself → this ticket only
 changes the icon technique.
  * The admin bar icons → handled by the sibling Toolbar ticket in this
 series (#65386).

 == Rationale ==

  * '''Consistency''': brings the admin menu in line with the icon set
 already used by the editors, and supports the broader WP 7.0 admin visual
 reskin (#64308).
  * '''Performance''': removes a major reason the icon font is loaded on
 every admin page, and lets new icons be added without growing a single
 large font file.

 Note: per feedback on #65089, screen-reader benefits here are modest
 compared to today's approach. The real gains are consistency, performance,
 and reliability.

 == Backward Compatibility ==

  * Low-risk and additive. Only Core's own default icons change; their
 position, labels, and behavior stay the same.
  * The public menu icon API is untouched: plugins and themes can still
 pass a Dashicons class or their own SVG when registering menu items, and
 the Dashicons stylesheet must stay available for them.
  * No change to how the menu is built, to its hooks, or to keyboard
 navigation.

 == Related Tickets / References ==

  * #65089 — parent / umbrella: replace Dashicons with @wordpress/icons
 across wp-admin
  * #64308 — broader WP 7.0 admin visual reskin (the "Admin Frame": sidebar
 + toolbar)
  * #25147 — existing SVG support and recoloring for admin menu icons
 (prior art)
  * #50423 — the "Collapse menu" button icon (in scope here)
  * #50539 — exploration of an icon-less admin menu (distinct: this ticket
 keeps the icons)
  * #47012 — proposal to simplify admin navigation (distinct: structure,
 not icon technique)
  * [https://github.com/WordPress/gutenberg/tree/trunk/packages/icons
 @wordpress/icons package]

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/65387>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list