# Consistent navigation in WordPress 7.1 with persistent toolbar — Make WordPress Core ## 🗂️ Triage — annotated highlights surfaced > [!note]- Cross Reference > - **Each icon means one thing everywhere** — a structural UX fix (not a tooltip patch) restoring one consistent meaning per icon across wp-admin. #xref > - **Plugin devs must verify toolbar nodes in the Site Editor** — new persistent-toolbar surface area; audit any `admin_bar_menu` integrations (Outpost & Co., Post Kinds/IndieWeb) before 7.1 ships. #xref #addendum ## 🧭 Bib capsule Make WordPress Core dev-note, "Consistent navigation in WordPress 7.1 with persistent toolbar," July 13, 2026. https://make.wordpress.org/core/2026/07/13/consistent-navigation-in-wordpress-7-1-with-persistent-toolbar/ ## 🧠 Author's thesis (Adler Q1+Q2) WordPress 7.1 makes the admin toolbar persistent in the editor by default, fixing a longstanding confusion where the top-left "W" logo/site icon doubled as both brand mark and "exit editor" back button. Three coordinated changes deliver the fix: the toolbar now shows in the editor everywhere except Distraction Free mode; a dedicated chevron replaces the overloaded logo as the back button; and the site icon (when set) moves into the toolbar. The result is a "one icon, one meaning" model across all of wp-admin. The Site Editor never had a toggleable toolbar before, so this is new behavior there — plugin authors who add toolbar nodes need to re-test, and a PHP opt-out snippet (`$screen->is_block_editor()`) is provided. ## 🧩 Key arguments - A logo icon doesn't semantically communicate "go back," so overloading it with that function caused persistent confusion; the fix targets the root cause structurally rather than papering over it with a tooltip. - The three changes map cleanly to one goal — each restores exactly one meaning to exactly one icon everywhere (W logo = About, site icon = site menu, chevron = back). - This is a breaking behavioral change specifically for the Site Editor, so admin-bar-integrating plugins have new surface area to test before general release. ## 🗒️ Notes — Literature atoms ### Each toolbar icon now means exactly one thing everywhere > [!quote] > "The result is a navigation model where each icon means one thing everywhere: the 'W' logo always opens the About page, the site icon (when set) always opens the site menu in the toolbar, and the chevron always goes back to the previous screen." - **Where**: dev-note body — the single sentence that best summarizes the fix - **Why**: The thesis of the whole change; a clean statement of the "one icon, one meaning" principle. ### Plugin developers should verify toolbar nodes in the Site Editor > [!quote] > "The Site Editor has no such mode, so a persistent toolbar in the Site Editor is a new behavior. If your plugin adds a node in the toolbar, it's worth double-checking if it still works correctly in the Site Editor." - **Where**: developer-facing compatibility subsection - **Why**: Direct, actionable warning for any Outpost & Co. or Post Kinds/IndieWeb admin-bar integration. ## 🔖 Permanent candidates - **Fix icon-overload confusion by giving every icon exactly one meaning** — When a UI icon is overloaded to serve two purposes (a brand logo doubling as a nav control), the durable fix is structural — one consistent meaning per icon across every screen — not a tooltip or documentation patch. ## Links - [[Open Source Governance MOC]] — a WordPress core UX-debt fix shipped through the public Trac/Gutenberg process, with a documented developer opt-out path — a governance-in-practice example. - [[WordPress 7.1 Beta 1 Ships With Responsive Styling, Media Overhaul, and Persistent Toolbar]] — this dev-note is the detailed technical writeup behind that release's one-line "persistent toolbar (Omnibar)" bullet. ## ✅ Processing checklist - [x] Claim atoms carried from deep-read analysis - [ ] Permanent candidates reviewed for promotion - [ ] Version History Diff check