Opened 7 weeks ago
Last modified 7 weeks ago
#64641 new enhancement
Admin Reskin: Add framed layout to wp-admin with scrollable content area
| Reported by: |
|
Owned by: | |
|---|---|---|---|
| Milestone: | Awaiting Review | Priority: | normal |
| Severity: | normal | Version: | |
| Component: | Administration | Keywords: | has-patch |
| Focuses: | ui, css | Cc: |
Description
This ticket introduces a framed layout for wp-admin as part of the WordPress 7.0 (or 7.1) admin visual refresh (#64308).
Why This Matters
The current admin layout uses a flat, full-bleed design where the content area fills the entire viewport. A framed layout with a visible background, rounded corners, and consistent spacing creates a more modern, focused interface that better separates navigation from content and matches the design already used in the Site Editor. It also matches what the new wp-boot powered screens such as the new Appearance -> Fonts screen look like.
Proposed Scope
Layout structure:
#wpwrapuses a fixed viewport height with a dark background (#1e1e1e)#wpcontentbecomes a flex column with padding to create the frame gap on right and bottom edges#wpbody-contentgets a white background,border-radius: 8px, andoverflow-y: autofor independent scrolling#wpbody-contentusesdisplay: flex; flex-direction: columnto keep the footer at the bottom viamargin-top: auto
Block editor integration:
- The editor's
.interface-interface-skeletonkeeps its nativeposition: fixedto preserve z-index stacking - Non-fullscreen mode gets
right: 16px,bottom: 16px,border-radius: 8px, andoverflow: hiddento fit within the frame - Fullscreen mode removes the frame entirely (no border-radius, no padding, no margin)
Footer:
#wpfooteris moved inside#wpbody-contentso it participates in the scroll area- Uses
margin-top: autowithin the flex column to always sit at the bottom
Screen meta (Help / Screen Options):
#screen-meta-linksusesalign-self: flex-endinstead offloat: rightto work within the flex column layout#screen-metapanel stays in normal flow so expanding it pushes content down
Responsive:
- On small screens, the frame is removed:
border-radius: 0,overflow: visible,height: auto - Screen meta margins adjust to
10pxon both sides
Key Principles
- CSS-Only Changes: Layout achieved through CSS, with one small change in
admin-footer.phpto reorder the footer position in the DOM - Backward Compatibility: All existing selectors preserved, block editor z-index behavior maintained by keeping
position: fixed - Fullscreen Unaffected: Fullscreen mode strips the frame for a clean, borderless experience
- Accessibility: Scrollable content area uses
overscroll-behavior: noneto prevent scroll chaining, focus styles remain visible
What This Is NOT
- No changes to the admin menu or admin bar
- No changes to admin color scheme values
- No JavaScript modifications
- No changes to block editor internal layout
Testing Approach
Test across multiple admin screens with varying content lengths:
- Short-content pages (Tools, Import/Export) — footer should be at the bottom, not floating mid-page
- Long-content pages (Posts list, Settings) — content should scroll within the frame with visible border-radius
- Block editor (Post, Page) — editor should fit within the frame with rounded corners in non-fullscreen mode
- Block editor fullscreen — frame should be completely removed
- Help / Screen Options panels — expanding should push content down, toggle buttons should move with the panel
- Dashboard — drag zone placeholders should have proper spacing
Verify at 100% and 200% zoom, in RTL layout, and on mobile viewport widths (frame should be disabled).
Related Resources
- Parent ticket: #64308
Change History (3)
This ticket was mentioned in PR #10936 on WordPress/wordpress-develop by @fabiankaegy.
7 weeks ago
#1
- Keywords has-patch added
#2
@
7 weeks ago
I know this is a very late addition and I'm totally fine if we decide to punt this to 7.1.
But I did want to open the PR now since I feel it really ties the admin reskin changes together nicely :)
#3
@
7 weeks ago
- Type changed from defect (bug) to enhancement
Looks nice! From the perspective of a plugin developer, I'm in favor of getting this into 7.0: Devs are going to have to check and potentially adjust styling for custom admin screens already, due to the other Admin Reskin changes. Having them repeat this for 7.1, if this ticket doesn't make it into 7.0, does feel unnecessary.
Trac ticket: https://core.trac.wordpress.org/ticket/64641