Skip to content

Administration: Replace Dashicons icon font with @wordpress/icons SVGs in the sidebar navigation - #12843

Open
faisalahammad wants to merge 10 commits into
WordPress:trunkfrom
faisalahammad:ticket/65387-replace-dashicons-with-svg-sidebar-icons
Open

Administration: Replace Dashicons icon font with @wordpress/icons SVGs in the sidebar navigation#12843
faisalahammad wants to merge 10 commits into
WordPress:trunkfrom
faisalahammad:ticket/65387-replace-dashicons-with-svg-sidebar-icons

Conversation

@faisalahammad

Copy link
Copy Markdown

https://core.trac.wordpress.org/ticket/65387

Replaces the Dashicons icon font glyphs on Core's default top-level admin sidebar menu items with inline SVG icons from the @wordpress/icons library, via the new wp_get_icon() API. Icons keep their current look, position, and labels; only the rendering technique changes, which removes the font glyph dependencies from Core's own menu and prepares for the eventual removal of the Dashicons font from wp-admin.

In scope: the default top-level menu icons (Dashboard, Posts, Media, Pages, Comments, Appearance, Plugins, Users, Tools, Settings) and the Collapse menu button icon. Adds the corresponding SVGs to the core icon library.

Out of scope: plugin and theme menu icons, the admin bar (#65386), and any restructuring of the sidebar navigation. The menu icon API is untouched. Base64 data URI, none/div, and dashicons icon types continue to render as before, and the Dashicons font stays registered for plugins that still rely on it.

Testing:

  • Log in as admin and confirm all default top-level menu icons render identically to the previous Dashicons glyphs.
  • Check hover, active, and current states for each icon.
  • Cycle through the admin color schemes and confirm the icons recolor via fill: currentColor.
  • Switch to an RTL locale and confirm the sidebar and the Collapse menu button point in the correct direction, including the folded state.
  • Register a menu item with a dashicons class and one with an SVG data URI and confirm both still render as before.

Replace the Dashicons icon font glyphs on the default top-level admin menu
items with inline SVG icons from the core icon library, via wp_get_icon().
Covers Dashboard, Posts, Media, Pages, Comments, Appearance, Plugins,
Users, Tools, Settings, and the Collapse menu button.

The menu icon API is unchanged: plugin and theme icons, base64 data URIs,
and dashicons classes all continue to work as before. The Dashicons font
remains registered for plugins that still use it.

Adds the corresponding SVGs to the core icon library and updates the
generated icon library manifest.

Props to those involved in the icons API work in wp-includes.

Fixes #65387.

See WordPress#12270.
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Core Committers: Use this line as a base for the props when committing in SVN:

Props faisalahammad.

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant