Repository navigation
Description
What
Editing a Navigation Menu today gives no indication of where that menu appears on the site. People change a menu and only find out afterwards that it also changed somewhere else.
This issue proposes a "Menu locations" panel next to the menu editor:
- It lists every template part the menu appears in, such as a header or footer, with a live preview that updates as the menu is edited.
- Each location has an Edit button that jumps straight into that template part.
- People can add or remove the menu from specific locations directly.
- A filter narrows the list to headers, footers, or everything.
| Live previews of every location | Choosing where the menu is shown |
|---|---|
![]() |
![]() |
🎥 For context, watch this part of my prototype walkthrough video, from 26:05. The Navigation Menus section, from 17:05, covers how all of these ideas fit together.
🔌 This flow is in the Create Not Learn editor plugin, where you can try it in WordPress Playground alongside the other menu changes.
Why
People regularly edit a menu without realising it's the same menu used in their header and footer. A typical request from a WordPress.com customer runs along the lines of "I only wanted to add the Privacy Page to the footer, not the header. Is that possible?"
The reverse is common too. People know they want a separate footer menu but don't know how to create one or swap it in. That problem sits outside this issue. It would be better served by a dedicated screen for headers and footers, where the menu used by each Navigation block is one of the key things people can change.
Seeing where a menu is used was also a recurring request in the FSE Outreach Program.
Showing every location turns "where is this used?" into something people can act on, not just wonder about.
How
- Find every template part containing a Navigation block that references the menu, and render each one as a preview alongside the editor.
- Add actions to assign or unassign the menu from each location, plus an Edit link into the template part.
- Include Navigation Overlays as a location, with a short description of what an overlay is. Unlike a header or footer, the name doesn't explain itself, so people need to know it's the menu that opens on smaller screens or from a menu button.
- The preview shows the template part on its own, not the full page. This is a known limitation of the prototype that's worth solving.
- Related follow-ups worth considering:
- A warning when editing a shared menu from inside a template, linking to the Navigation screen so people can see everywhere it's used.
- A UX review of how menus appear in the multi-entity save panel, which is the other place this confusion shows up.
This continues the preview frame work in #76037, which @jeryj, @jasmussen, @fcoveram and I scoped together during the 7.1 cycle. That discussion left some questions open, such as whether to show every location or one at a time. User testing should answer them.
Known technical constraint
WordPress has no way to tell which template parts are actually in use on a site. It can't say which header is the primary header, or which footer is the one people see. So the panel has to show every template part of each type that contains the menu.
A theme that ships with lots of header, footer or Navigation Overlay template parts will list all of them, which quickly becomes overwhelming. This applies to every type of template part, not only headers.
Ideally the panel would only show template parts that are used in a template on the site. That needs a way to work out which template parts are in use. It's a key blocker to unpick before the UX of this area can fully work.
User Stories
As a site owner, I want to see all the locations where my menu appears while I'm editing it, so I can understand the scope of the changes I'm making across my site.
As a site owner, I want to update the locations where my menu is used across my site, so I can make sure it only shows in the places I want.
As a site owner, I want to edit a specific location where my menu is used, so I can manage how the menu displays in that location.
As a site owner, I want to see when my menu is used in a Navigation Overlay, so I know that changes to my menu will also affect that overlay.


Activity