📝 The Menu That Disappeared the Moment You Changed Themes
A carefully built navigation menu can simply vanish from the site the instant a new theme is activated – not because the menu itself was deleted, but because WordPress menus are assigned to specific “theme locations,” and those location names are defined by each theme individually, so a menu assigned to the old theme’s “primary” location has nowhere to appear under a new theme that defines its locations differently.
🔎 The Problem
Appearance > Menus still shows the menu, fully intact, with every page and link exactly as it was built – but Appearance > Customize > Menus, or the site itself, shows no menu assigned to any visible location, because the new theme’s `register_nav_menus()` call defines a different set of location names than the previous theme did.
✅ Fix: Reassign the Menu to the New Theme’s Locations
- Appearance > Menus > Manage Locations tab lists every navigation location the CURRENT theme defines, alongside a dropdown to assign an existing menu to each one – this is usually a two-minute fix once you’re looking at the right screen, since the menu itself was never actually lost.
- If the new theme defines menu locations with unfamiliar names (a theme using ‘header-menu’ where the old one used ‘primary’, for instance), reading the new theme’s documentation for its specific location names avoids guessing which one corresponds to where the main navigation actually displays.
- For a theme that defines NO menu locations at all (rare, but happens with minimal or block-based themes), the menu needs to be added as a Navigation block directly in the site editor or a template part instead of through the classic Locations screen.
⚠️ Why This Catches People Off Guard
- Nothing about switching themes produces an error or a warning here – from WordPress’s point of view, everything worked exactly as designed, since a menu location is deliberately theme-specific and switching themes is expected to potentially need re-mapping.
- This is worth checking immediately after any theme switch, before assuming a missing menu means something was deleted or corrupted – the Manage Locations tab is almost always where the actual explanation and the fix are both waiting.
A theme switch doesn’t delete a menu – it just stops recognizing where the old theme used to hang it, and the new theme has its own hooks waiting to be told what to hang there instead.
