{"id":124509,"date":"2026-07-13T10:58:16","date_gmt":"2026-07-13T10:58:16","guid":{"rendered":"https:\/\/make.wordpress.org\/core\/?p=124509"},"modified":"2026-07-13T10:58:16","modified_gmt":"2026-07-13T10:58:16","slug":"consistent-navigation-in-wordpress-7-1-with-persistent-toolbar","status":"publish","type":"post","link":"https:\/\/make.wordpress.org\/core\/2026\/07\/13\/consistent-navigation-in-wordpress-7-1-with-persistent-toolbar\/","title":{"rendered":"Consistent navigation in WordPress 7.1 with persistent toolbar"},"content":{"rendered":"<p class=\"wp-block-paragraph\">WordPress 7.1 makes navigation more consistent across the whole <span tabindex='0' class='glossary-item-container'>admin<span class='glossary-item-hidden-content'><span class='glossary-item-header'>admin<\/span> <span class='glossary-item-description'>(and super admin)<\/span><\/span><\/span> interface, including the editor, where the difference is most noticeable.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In the editor, the top-left \u201cW\u201d logo \/ site icon served as the back button, and clicking it took you out of the editor. But a \u201cW\u201d logo \/ site icon doesn\u2019t read as a back button, and using it for navigation was a frequent source of confusion. Three changes are implemented to fix this situation:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>the toolbar now appears in the editor as it does everywhere else (except in the Distraction Free mode),<\/li>\n\n\n\n<li>the \u201cW\u201d logo \/ site icon is replaced with a dedicated back button (a chevron), and<\/li>\n\n\n\n<li>the site icon, when set, is shown in the toolbar.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The result is a navigation model where each icon means one thing everywhere: the \u201cW\u201d 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. The site title also stays visible throughout the editor, including on the editing canvas. See the following images:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Before<\/th><th>After<\/th><\/tr><\/thead><tbody><tr><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image.png\" alt=\"\"><\/a><\/td><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-1.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-1.png\" alt=\"\"><\/a><\/td><\/tr><tr><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-2.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-2.png\" alt=\"\"><\/a><\/td><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-3.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-3.png\" alt=\"\"><\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">or with site icon:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Before<\/th><th>After<\/th><\/tr><\/thead><tbody><tr><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-4.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-4.png\" alt=\"\"><\/a><\/td><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-7.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-7.png\" alt=\"\"><\/a><\/td><\/tr><tr><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-5.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-5.png\" alt=\"\"><\/a><\/td><td><a href=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-6.png\"><img decoding=\"async\" style=\"width: 450px\" src=\"https:\/\/make.wordpress.org\/core\/files\/2026\/07\/image-6.png\" alt=\"\"><\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">What it means for users<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The toolbar will be shown in Post and Site Editors by default, as part of the persistent navigation layer. If you\u2019d rather work without it, turn on the <a href=\"https:\/\/wordpress.org\/documentation\/article\/distraction-free-mode\/\">Distraction Free<\/a> mode, where the toolbar is hidden as it is today in that mode.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">What it means for <span tabindex='0' class='glossary-item-container'>plugin<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Plugin<\/span> <span class='glossary-item-description'>A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory <a href=\"https:\/\/wordpress.org\/plugins\/\">https:\/\/wordpress.org\/plugins\/<\/a> or can be cost-based plugin from a third-party.<\/span><\/span><\/span> developers<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Before WordPress 7.1, the toolbar could already appear in the Post Editor when the fullscreen mode is turned off. 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\u2019s worth double-checking if it still works correctly in the Site Editor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you\u2019d prefer not to show your plugin\u2019s toolbar node in the editor at all, you can <span tabindex='0' class='glossary-item-container'>filter<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Filter<\/span> <span class='glossary-item-description'>Filters are one of the two types of Hooks <a href=\"https:\/\/codex.wordpress.org\/Plugin_API\/Hooks\">https:\/\/codex.wordpress.org\/Plugin_API\/Hooks<\/a>. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output.<\/span><\/span><\/span> it out on editor screens, e.g. by checking <code>$screen-&gt;is_block_editor()<\/code> as follows:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: php; title: ; notranslate\" title=\"\">\nadd_action(\n    'admin_bar_menu',\n    function ( WP_Admin_Bar $wp_admin_bar ) {\n        $screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;\n\n              \/\/ use this check to hide the node in the Site Editor\n              if ( $screen &amp;&amp; 'site-editor' === $screen-&gt;id ) {\n                      return;\n              }\n              \/\/ ... or use this check to hide the node in any block editor\n              if ( $screen &amp;&amp; $screen-&gt;is_block_editor() ) {\n                      return;\n              }\n\n\n        $wp_admin_bar-&gt;add_node( ... );\n    },\n    100\n);\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">Additional resources<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span tabindex='0' class='glossary-item-container'>Trac<span class='glossary-item-hidden-content'><span class='glossary-item-header'>Trac<\/span> <span class='glossary-item-description'>An open source project by Edgewall Software that serves as a bug tracker and project management tool for WordPress.<\/span><\/span><\/span> tickets: <a href=\"https:\/\/core.trac.wordpress.org\/ticket\/65091\">#65091<\/a>, <a href=\"https:\/\/core.trac.wordpress.org\/ticket\/65088\">#65088<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/WordPress\/gutenberg\/issues\/79036\">Iteration issue<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Props to <a href=\"https:\/\/profiles.wordpress.org\/tyxla\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>tyxla<\/a>, <a href=\"https:\/\/profiles.wordpress.org\/mayanktripathi32\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>mayanktripathi32<\/a>, <a href=\"https:\/\/profiles.wordpress.org\/joen\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>joen<\/a>, <a href=\"https:\/\/profiles.wordpress.org\/lucasmdo\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>lucasmdo<\/a>, <a href=\"https:\/\/profiles.wordpress.org\/mamaduka\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>mamaduka<\/a>, and <a href=\"https:\/\/profiles.wordpress.org\/annezazu\/\" class=\"mention\"><span class=\"mentions-prefix\">@<\/span>annezazu<\/a> for reviewing this post.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/make.wordpress.org\/core\/tag\/7-1\/\" class=\"tag\"><span class=\"tag-prefix\">#<\/span>7-1<\/a>, <a href=\"https:\/\/make.wordpress.org\/core\/tag\/editor\/\" class=\"tag\"><span class=\"tag-prefix\">#<\/span>editor<\/a>, <a href=\"https:\/\/make.wordpress.org\/core\/tag\/dev-notes\/\" class=\"tag\"><span class=\"tag-prefix\">#<\/span>dev-notes<\/a>, <a href=\"https:\/\/make.wordpress.org\/core\/tag\/dev-notes-7-1\/\" class=\"tag\"><span class=\"tag-prefix\">#<\/span>dev-notes-7-1<\/a><\/p>\n<nav class='o2-post-footer-actions'><ul class='o2-post-footer-action-row'><li class='o2-post-footer-action'><a href=\"https:\/\/login.wordpress.org\/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fcore%2F2026%2F07%2F13%2Fconsistent-navigation-in-wordpress-7-1-with-persistent-toolbar%2F%23respond&#038;locale=en_US\" title=\"Login to Reply\"  class=\"genericon  genericon-reply\"  data-action=\"login-to-reply\"  data-actionstate=\"default\" >Login to Reply<\/a><\/li><\/ul><div class='o2-post-footer-action-likes'><\/div><ul class='o2-post-footer-action-row'><\/ul><\/nav>","protected":false},"excerpt":{"rendered":"<p>WordPress 7.1 makes navigation more consistent across the whole adminadmin (and super admin) interface, including the editor, where the difference is most noticeable. In the editor, the top-left \u201cW\u201d logo \/ site icon served as the back button, and clicking it took you out of the editor. But a \u201cW\u201d logo \/ site icon doesn\u2019t [&hellip;]<\/p>\n","protected":false},"author":20618145,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false,"jetpack_seo_schema_type":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[1175],"tags":[5885,1443,5894,700],"class_list":["post-124509","post","type-post","status-publish","format-standard","hentry","category-general","tag-7-1","tag-dev-notes","tag-dev-notes-7-1","tag-editor","mentions-annezazu","mentions-joen","mentions-lucasmdo","mentions-mamaduka","mentions-mayanktripathi32","mentions-tyxla","author-fushar"],"revision_note":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p2AvED-wod","jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/posts\/124509","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/users\/20618145"}],"replies":[{"embeddable":true,"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/comments?post=124509"}],"version-history":[{"count":16,"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/posts\/124509\/revisions"}],"predecessor-version":[{"id":124554,"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/posts\/124509\/revisions\/124554"}],"wp:attachment":[{"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/media?parent=124509"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/categories?post=124509"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/make.wordpress.org\/core\/wp-json\/wp\/v2\/tags?post=124509"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}