Make WordPress Core

Opened 7 days ago

Last modified 7 hours ago

#64547 new enhancement

Admin Reskin: Update button and input field styling to align with WordPress Design System

Reported by: fabiankaegy's profile fabiankaegy Owned by:
Milestone: 7.0 Priority: normal
Severity: normal Version:
Component: Administration Keywords: has-patch
Focuses: ui, accessibility, css Cc:

Description (last modified by sabernhardt)

This ticket covers the visual reskin of buttons and input fields in wp-admin as part of the WordPress 7.0 admin visual refresh (#64308).

Why This Matters

Buttons and input fields are the most common interactive elements in wp-admin. Consistent styling improves usability, reduces cognitive load, and makes older screens feel closer to the editor experience users already know.

Why Buttons and Inputs Are Grouped

These two components frequently appear adjacent to one another in the admin interface:

  • Search boxes with submit buttons
  • Bulk action dropdowns with Apply buttons
  • Settings pages with text inputs and Save Changes buttons
  • Password fields with toggle buttons

Updating the height or density of one component without the other creates visual misalignment. This ticket addresses both together to ensure a cohesive result.

Proposed Scope

Buttons:

  • Primary, secondary, tertiary, and link buttons
  • Destructive variants
  • All interactive states (default, hover, focus, active, disabled)

Inputs:

  • Text inputs, URL, email, password, number, search
  • Select dropdowns and textareas
  • Checkboxes and radio buttons
  • Disabled and readonly states

Key Principles

  • CSS-Only Changes: No markup or JavaScript modifications
  • Backward Compatibility: All existing selectors and admin color schemes preserved
  • Design System Alignment: Heights, spacing, and focus treatment aligned with Gutenberg components
  • Accessibility: Focus rings visible at all zoom levels, proper contrast ratios maintained

What This Is NOT

  • No new CSS custom properties
  • No changes to functional behavior (validation, keyboard interactions)
  • No selector removals or renames

Testing Approach

Test in real admin workflows across multiple screens:

  • Dashboard widgets and bulk actions
  • Settings pages (General, Reading, Discussion)
  • Plugin search and install
  • Post editor meta boxes

Verify in at least two color schemes (modern and light), at 100% and 200% zoom, and in RTL layout.

Related Resources

Change History (9)

#2 @sabernhardt
6 days ago

  • Description modified (diff)
  • Focuses accessibility added
  • Milestone changed from Awaiting Review to 7.0

#3 @Joen
4 days ago

Thanks for this work. Designwise, I support this, and appreciate that this is not a new custom properties effort: those become public APIs to support forever which needs an extremely carefully considered approach. And at the same time, this effort does not preclude a color system modernization happening in the future, it's just CSS to modernize and make uniform the work.

I'm a bit short for time on testing, are there screenshots or visuals to aid that process? Otherwise I'll try and come back when I have a moment.

@audrasjb commented on PR #10783:


39 hours ago
#4

Hi @fabiankaegy,
This looks globally good to me.
I tested this PR on a fresh install, and I went into each individual admin screen, on both desktop and small screen views.
This looks almost good to me, I only found a few glitches:

Media Library vertical misalignment

https://github.com/user-attachments/assets/1cfe4454-03ae-479d-bd77-39899efb19b6

Settings vertical misalignement on lists

https://github.com/user-attachments/assets/22e78ab9-b849-4b6f-83ab-13b9286d3736

Then I tested a few popular plugins, like Classic Editor, CF7, Redirection, SCF, and others. Globally settings pages are OK, I only found a few glitches, like:

Alignement bug on Visual/Code tabs on Classic Editor

https://github.com/user-attachments/assets/8aa98104-157c-4363-975c-605cbf98560c

Alignement bug on Redirection filters

https://github.com/user-attachments/assets/b1d432f8-6c31-4b96-99d4-75688131d282

More tests on popular plugins are welcome.
For example: back in the years, here is the list of plugins I tested when we shipped the Admin Accessible Redesign in WordPress 5.3: https://make.wordpress.org/core/2019/10/15/report-wp-5-3-admin-css-changes-tested-against-top-20-plugins/

#5 @audrasjb
38 hours ago

Hi there,
I tested this changeset on each admin screen on both dsektop and small screens, then I installed a few popular plugins like Classic Editor, CF7, Redirection, SCF, and others. Globally notifices are OK.

I didn't find any accessibility issue as well.

@Joen commented on PR #10783:


36 hours ago
#6

From Jb's screenshots above, one note I'd add is that you can use either the 32px or 40px height for most of the controls, e.g. try the "compact" view here. 32px may be a better fit for many of these.

@Joen commented on PR #10783:


36 hours ago
#8

Oh yeah, nice one. These come to mind as benefitting from 32px compact sizes:

https://github.com/user-attachments/assets/a3d64bb1-3488-46cf-bfa0-6477c0a46c25

https://github.com/user-attachments/assets/b73a97c0-791c-47d5-ac6f-5b7ea3dd75c0

https://github.com/user-attachments/assets/ba5b8338-33e2-4860-865d-fe3ed8da1950

https://github.com/user-attachments/assets/6f3ff3fc-7d3a-4b03-b9df-d7f33fb1e6f2

This ticket was mentioned in Slack in #accessibility by joedolson. View the logs.


7 hours ago

Note: See TracTickets for help on using tickets.