Make WordPress Core

Opened 2 weeks ago

Last modified 2 weeks ago

#65387 new enhancement

Sidebar navigation: Replace Dashicons icon font with @wordpress/icons SVGs in the sidebar navigation

Reported by: lucasmdo's profile lucasmdo Owned by:
Milestone: Awaiting Review Priority: normal
Severity: normal Version:
Component: Administration Keywords: needs-patch
Focuses: ui, accessibility, css, rtl, administration, performance Cc:

Description

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)
  • @wordpress/icons package

Change History (2)

#1 @lucasmdo
2 weeks ago

  • Summary changed from Administration: Replace Dashicons icon font with @wordpress/icons SVGs in the admin menu to Sidebar navigation: Replace Dashicons icon font with @wordpress/icons SVGs in the sidebar navigation

Updating the title to be clearer.

#2 @lucasmdo
2 weeks ago

#65089: parent / umbrella: replace Dashicons with @wordpress/icons across wp-admin

Note: See TracTickets for help on using tickets.