Classic themes commonly use menu locations backed by wp_nav_menu. Block themes commonly use Navigation blocks and wp_navigation entities. Switching the selected theme does not make these two storage models identical.
Before synchronization
- Back up the database.
- Identify the source menu and destination navigation entity.
- Review custom links, hierarchy, labels, descriptions, and plugin-added item data.
- Confirm which theme owns the header and footer templates.

Safeguards
ThemeRouter runs a preflight, asks for confirmation before mutating larger mapped menus, enforces a hard item limit, and preserves navigation item data during classic-to-block synchronization.
Validate the result
- Desktop and mobile navigation structure.
- Dropdown keyboard behavior and focus order.
- Current-menu state, external links, and custom attributes.
- Header and footer navigation in every routed theme.
Menu synchronization changes stored WordPress navigation data. Treat it separately from theme preview and keep a database backup before running it.
