Skip to content

Tips and troubleshooting

  • Menu items missing or wrong – Ensure the menu API is returning data (check network tab for the menu endpoint). Use Reset Menu in the sidebar (or Clear cache / Reset in Menu Management) to force a fresh load. If you use role simulation, switch back to your real role to see your full menu.

  • WP mode shows blank or error – The iframe loads a WordPress URL; if that URL requires login or returns an error, the iframe will show it. Ensure you're logged in and the WordPress URL is correct. Try opening the same URL in a new tab (e.g. wp-admin/edit.php?post_type=post) to confirm it works.

  • Reorder or rename not sticking – Overrides must be saved (the drawer or context usually saves on change or on close). If you have "Reset to default" or "Reset Menu," that clears overrides. Check that you're not resetting by accident. If overrides are stored per role, ensure you're viewing the menu as the right role.

  • Sidebar collapsed and I can't find the trigger – On small screens, use the hamburger in the header to open the sidebar. If "auto-hide" is on, move the mouse to the left edge of the window; the sidebar slides in. You can turn off auto-hide in the sidebar settings (gear) popover.

  • Admin bar doesn't match theme – Go to Settings → Admin Bar and set Admin bar theme to Auto so it follows the interface theme (light/dark). Or set it explicitly to Light or Dark.

  • Menu Management drawer doesn't open – Confirm you're clicking Menu (or the equivalent) in the user menu at the bottom of the sidebar. If the entry is missing, check permissions or feature flags; some roles may not have access to menu management.

Quick reference

TopicDetails
Sidebar
Main nav; items from WordPress menu + overrides; search, pin, expand; user menu at bottom.
WP mode
Route #/wp/*; iframe with WordPress admin; Page Mode menu in header; optional "Set as default."
Menu Management
Drawer from user menu (or Settings); drag-and-drop reorder, rename; overrides; sidebar = live preview.
Admin bar
Top bar; Settings → Admin Bar for theme (Auto/Light/Dark).
Reset
Reset Menu (sidebar when no search results) or Reset to default (drawer) clears overrides and cache.