Skip to content

Tips and troubleshooting

  • Menu items missing or wrong: Use Reset Menu in the sidebar (or Reset to default in Menu Management) to force a fresh load. If you use role preview, switch back to your real role to see your full menu. After activating or deactivating plugins, wait a moment for the sidebar to refresh.

  • Submenu changes not visible: Expand the parent in Menu Management and confirm overrides on the submenu rows, not only the parent. Collapse the parent before reordering top-level items.

  • Section title or spacing missing in sidebar: Confirm the spacing row is visible (eye toggle) and that you saved overrides. Spacing works at the top level and inside expanded submenus.

  • Sidebar settings not applying to a user: That user may have personal overrides from the sidebar gear menu. Open Sidebar settings in Menu Management and use Remove all on the local overrides banner, or ask them to reset from the gear popover.

  • 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.

  • Gutenberg or block plugin panels look wrong in WP mode: Update to the latest FleekDash release. Recent versions scope editor styling so native Gutenberg chrome and third-party block panels (such as Kadence) keep correct colors and controls inside the iframe. If issues persist, hard-refresh the page or clear cache.

  • Reorder or rename not sticking: Overrides save automatically in Menu Management. Reset to default clears them for the selected role. Check that you are editing the correct role in the role dropdown.

  • 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. All shortcuts
WP mode
Route #/wp/*; iframe with WordPress admin; Page Mode menu in header; optional "Set as default."
Menu Management
Drawer from user menu; edit top-level items and submenus; spacing, section titles, icons; role preview; Sidebar settings; sidebar = live preview. Full guide
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.

Shortcuts

Available on every sidebar item (main items, submenus, collapsed popover items). Added in 2.6.3.

Click and hold means pressing the mouse button on a menu item and keeping it down for about 750 ms before release. Same idea as long press on a touchscreen, but with a mouse or trackpad.

ActionResult
Click
Open that screen inside the FleekDash window (same browser tab)
Ctrl/Cmd + click
Open the same FleekDash route in a new tab
Click and hold (~750 ms)
Open that WordPress screen in a new browser tab (not inside the FleekDash window)
Ctrl/Cmd + click and hold
Open native classic wp-admin for that item (fleekdash=off) in a new tab
Middle-click
Same as click and hold: new browser tab, outside the FleekDash window

Use click for everyday in-shell navigation. Use click and hold or middle-click to open full WordPress admin in its own tab while FleekDash stays open in the current tab. Use Ctrl/Cmd + click and hold for classic admin on that menu item only (toolbar Classic mode, but per item).