Synchronize Classic Menus and Block Navigation

Review and synchronize menu data when a migration crosses classic and block theme navigation systems.

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.
ThemeRouter Menu Sync screen showing classic menu mappings, block navigation destinations, synchronization status, and update controls
Menu Sync maps a classic menu to block navigation and shows whether each mapping is synced or needs an update.

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.

Was this helpful?