#64546 closed enhancement (fixed)
Change the default admin color scheme from "Default" to "Modern"
| Reported by: |
|
Owned by: |
|
|---|---|---|---|
| Milestone: | 7.0 | Priority: | normal |
| Severity: | normal | Version: | |
| Component: | Administration | Keywords: | has-patch commit needs-user-docs add-to-field-guide |
| Focuses: | ui, accessibility, administration | Cc: |
Description (last modified by )
This is a subticket of #64308 (WordPress Admin Visual Reskin).
As part of the WordPress 7.0 visual refresh, this ticket proposes changing the default admin color scheme from "Default" (fresh) to "Modern" for all users.
Background
The "Default" color scheme has been the admin default since WordPress 3.8. The "Modern" color scheme was introduced more recently and better aligns with the WordPress Design System and the visual direction established by the Block Editor and Site Editor.
With the visual reskin effort underway, switching to the "Modern" scheme as the default provides a more cohesive experience out of the box.
Proposed Changes
- Update the default for new users: Change the fallback color scheme from
freshtomodernin user creation and the color picker. - Migrate existing users: Add a database upgrade routine that migrates users currently set to
freshtomodern.
Files Affected
src/wp-includes/version.php– Bump$wp_db_versionsrc/wp-admin/includes/upgrade.php– Addupgrade_700()functionsrc/wp-includes/user.php– Change default inwp_insert_user()src/wp-admin/includes/misc.php– Change fallback inadmin_color_scheme_picker()
Important Consideration
WordPress does not track whether a user explicitly selected a color scheme or inherited the default. This means users who intentionally chose "Default" will also be migrated to "Modern". These users can re-select "Default" from their profile settings if desired.
The "Default" color scheme will remain available as an option for users who prefer it.
Testing
- Verify new user accounts receive the "Modern" color scheme
- Verify the upgrade routine migrates existing
freshusers tomodern - Verify users with other color schemes (Light, Blue, Midnight, etc.) are unaffected
- Verify "Default" scheme remains selectable in user profile
Related Tickets
- #64308 – Explore a "Coat-of-Paint" Visual Reskin of the WordPress Admin for WordPress 7.0
Attachments (5)
Change History (24)
This ticket was mentioned in PR #10782 on WordPress/wordpress-develop by @fabiankaegy.
7 weeks ago
#1
- Keywords has-patch added
#2
@
7 weeks ago
- Description modified (diff)
- Focuses accessibility added
- Milestone changed from Awaiting Review to 7.0
@fabiankaegy commented on PR #10782:
6 weeks ago
#3
@mukeshpanchal27 Great catch! I found a few more similar instances where fresh was used as a fallback in case no value was set. Should all be fixed now!
#4
@
6 weeks ago
I would support this change, as the modern color scheme matches in color with those of WordPress.org, and features higher contrast than the current default.
Should the schemes be renamed? I.e. Default → Classic, Modern → Default?
#6
@
5 weeks ago
Environment
WordPress: 7.0-alpha-20260202.084607
PHP: 8.2.30
Server: pache/2.4.66
Database: mysqli 10.6.24-MariaDB
Browser: Firefox 148.0b8
OS: MacOS 26.2
Theme: Twenty Twenty-Five 1.4
MU Plugins: None activated
Test report
- Before the upgrade to the PR version
Creation of a
blueuseruser withbluecolor scheme selected
Creation of awebmasteruser withclassiccolor scheme selected
adminuser has theclassiccolor scheme
- After upgrade to the PR version
The screen with the Database upgrade button showed up -> OK
webmasteruser color scheme is nowmodern-> OK
adminuser color scheme is nowmodern-> OK
userblueuser color scheme is stillblue-> OK
Creation of a new user, themoderncolor scheme is automaticaly selected -> OK
Change of color scheme for userwebmastertoclassic-> OK
#7
@
5 weeks ago
I fully support this also and it looks like it tests well. To me this is ready to get into at least an initial commit as a result. What does everyone else think? If I was to pick one of these it would to start with this one.
@fabiankaegy commented on PR #10782:
5 weeks ago
#8
@peterwilsoncc thanks for the feedback :) all items should now be covered. Would love another review :)
@peterwilsoncc commented on PR #10782:
5 weeks ago
#9
@fabiankaegy What do you think about changing the onscreen display to Default which was done last time the default theme was changecd.
This ticket was mentioned in Slack in #accessibility by joedolson. View the logs.
4 weeks ago
@phpbits commented on PR #10782:
4 weeks ago
#11
@fabiankaegy I tested the updates and verified that they work on my end using this playground link: https://playground.wordpress.net/wordpress.html?pr=10782.
#12
@
4 weeks ago
Thanks @fabiankaegy!
Admin: Change default admin color scheme to 'modern' ✅ I am able to see the Default colour scheme to Modern now(compared with an existing WP Dashboard)
Testing Notes:
Verify new user accounts receive the "Modern" color scheme✅
Verify users with other color schemes (Light, Blue, Midnight, etc.) are unaffected✅
Verify "Default" scheme remains selectable in user profile✅
Screens attached in Attachments section.
Tested on Chrome 144 on WP Playground
@fabiankaegy commented on PR #10782:
4 weeks ago
#13
Unless I'm overlooking something, the fallback color scheme set in wp_color_scheme_settings() is still set to 'fresh'; this should probably also be updated to 'modern', along with other checks in that function.
@joedolson great catch! Fixed
#14
@
4 weeks ago
Test Report
Description
This report validates whether the indicated patch works as expected.
Patch tested: https://patch-diff.githubusercontent.com/raw/WordPress/wordpress-develop/pull/10782.diff
Environment
- WordPress: 7.0-alpha-20260211.075611
- PHP: 7.4.33
- Server: PHP.wasm
- Database: WP_SQLite_Driver (Server: 8.0.38 / Client: 3.51.0)
- Browser: Chrome 144.0.0.0
- OS: macOS
- Theme: Twenty Twenty-Five 1.4
- MU Plugins: None activated
- Plugins:
- Test Reports 1.2.1
===Actual results
- Admin: Change default admin color scheme to 'modern' ✅
- Testing Notes:
Verify new user accounts receive the "Modern" color scheme✅
Verify "Default" scheme remains selectable in user profile✅
Screenshots are attached for reference:
https://core.trac.wordpress.org/attachment/ticket/64546/New%20Note.jpeg
https://core.trac.wordpress.org/attachment/ticket/64546/New%20Note.2.jpeg
#15
@
4 weeks ago
- Keywords commit needs-user-docs added
As a Core Committer I say +1 on committing this changeset.
Adding needs-user-docs as a large lot of screenshots will be outdated… though this is not a major issue since it's only a color change.
Since no owner is designated for this ticket, I'm self-assigning it to make sure it's committed before beta 1. But @fabiankaegy feel free to commit it if you want, you're the boss here.
#17
@
4 weeks ago
@audrasjb I was planning on committing this tomorrow morning, though for this one in particular I'm not 100% sure about what @jorbin mentioned in regards to the commit this lands in for the DB migration: https://github.com/WordPress/wordpress-develop/pull/10782#discussion_r2796117546 so I will need to read up on that a bit more. If it makes sense to pair for this one also happy to do so. Or I can do the other three and leave this one to someone more experienced with committing :) All options are good by me
Trac ticket: https://core.trac.wordpress.org/ticket/64546