📝 WordPress: Fix a Navigation Block Losing Submenu Items After Sync
The core Navigation block can either store its menu directly inside the block (as nested list-item blocks) or link to a classic menu synced in through Appearance > Manage Menus. When that sync runs again, it pulls its items strictly from the classic menu’s own stored entries — any submenu items you added purely inside the block editor were never part of what the classic menu tracks, so the next sync overwrites the block’s content with the classic menu’s list and those extra items simply vanish.
🔎 The Problem
Classic menu 'Main Nav': Home, Products, About, Contact In the block editor, a submenu item 'Products > Accessories' is added directly under Products (block-editor-only edit, not saved back to the classic menu). Appearance > Manage Menus > sync is run again for 'Main Nav' -> Navigation block is rebuilt from the classic menu's 4 items only. 'Accessories' submenu item: gone, with no warning.
✅ Fix: Pick One Editing Source and Stop Alternating
- Treat one source as the editing source of truth for a given menu — either the classic Menus screen or the block editor’s Navigation block — and stop making changes to the same menu from both places.
- Before running Manage Menus sync again, note any submenu items added directly in the block editor, since the sync can silently drop them rather than merging the two sources together.
- If you need both a classic menu location and block-only custom submenu items, duplicate the Navigation block into a second, unsynced entity instead of pointing both the classic menu and your manual edits at the same navigation post.
🚨 Why This Is Dangerous
- Losing submenu links silently on a sync can leave visitors without navigation to pages that are otherwise still perfectly live, and it often isn’t noticed until someone reports a missing dropdown.
A synced menu only knows about the items its source actually tracked — anything added somewhere else was never really saved to that source in the first place.
