Troubleshooting

The most common problems and their solutions — with diagnostic commands for the browser console.

First diagnostic steps

Before digging deeper, check these four points — they resolve the majority of cases:

  1. Menu saved? Changes in the menu editor only take effect after Save Menu.
  2. Cache cleared? Clear the browser cache (Ctrl+F5) and any page cache plugin (WP Rocket, LiteSpeed etc.).
  3. Activation mode checked? Settings → SuperNav → Activation mode — when in doubt, use "All menus".
  4. Plugin version up to date? This page documents Core 3.10.6. Update older versions first.
Quick test in the browser console (F12):
document.querySelectorAll('.lmm-has-mega').length — the result must be > 0, otherwise the panel is not active on the menu item at all.

Panel does not open

Symptom: hovering/clicking the menu item shows no mega panel.

  • Panel type set to "No mega panel"? → Change it to "Columns with icons & descriptions" (or another type).
  • Menu saved after the change?
  • Browser console: document.querySelectorAll('.lmm-has-mega').length — must be > 0.
  • Plugin settings: set the activation mode to "All menus".
  • JSON empty or invalid? A panel without valid columns is not rendered — see JSON errors.
🖼️ Screenshot: panel type selection in the menu editor img/ts-panel-typ.png · recommended 1000×500

Panel flickers on hover

Symptom: the panel opens and closes rapidly.

  • Increase the close delay: Settings → SuperNav → Close delay → 300
  • Check the theme CSS: does the theme set position: static !important on <li> elements?
  • Add the theme fix CSS to style.css — see theme compatibility in the documentation.

Icons not visible

Symptom: empty squares or nothing at all instead of Dashicons.

On pages that render without wp_head() (e.g. standalone landing templates), the Dashicons are missing. They must be included via the theme filter:

add_filter('taxbot_landing_lmm_head_html', function (string $html): string {
    // Dashicons for SuperNav icons
    $dashicons_url = includes_url('css/dashicons.min.css');
    $ver           = get_bloginfo('version');
    $html .= '<link rel="stylesheet" id="dashicons-css" href="'
           . esc_url($dashicons_url) . '?ver=' . esc_attr($ver)
           . '" media="all" />' . "\n";
    return $html;
}, 5);

Test in the browser console:

document.querySelector('link[href*="dashicons"]') ? 'Dashicons loaded' : 'missing'

On regular WordPress pages the plugin loads the Dashicons automatically.

JSON errors (red marker in the editor)

Symptom: the JSON field shows a red error marker, the panel stays empty.

  • Only use straight double quotes " — no single quotes ' and no typographic quotes “ ” « ».
  • No trailing comma after the last element in arrays and objects.
  • Use the { } Format button — it shows the exact error position.
  • When copying from Word/email: paste the text into a plain text editor first (removes smart quotes).
  • Or simply use our JSON tester — it finds syntax and field errors instantly.
Most common cause: "typographic quotes" copied from word processors. JSON only accepts ".

Badge does not appear

Symptom: the "New" badge on an item is not displayed.

Both fields must be set: "badge" and "badge_url".

{
  "label": "Invoices",
  "url": "/invoices",
  "badge": "New",
  "badge_url": "/invoices/new"
}

Colors not applied

Symptom: configured colors do not show up in the frontend.

  • Check the priority: item JSON > column JSON > 🎨 tab > plugin settings. A higher level overrides the lower one.
  • Write hex colors correctly with #: "#ef4444", not "ef4444".
  • Clear the page cache — color values end up in the rendered HTML.

Details: configuring colors in the documentation.

Panel too far right or left

Symptom: the panel extends beyond the screen edge.

The plugin detects edge overflow automatically. If needed, force it manually:

/* Always left-aligned */
.lmm-has-mega .lmm-mega-panel { left: 0 !important; right: auto !important; }

/* Always right-aligned */
.lmm-has-mega .lmm-mega-panel { left: auto !important; right: 0 !important; }

Theme conflicts

Symptom: layout breaks, the panel appears in the wrong place or behind other elements.

  • z-index conflict: theme header elements overlap the panel. Test CSS:
    .lmm-mega-panel { z-index: 99999 !important; }
  • overflow: hidden on header containers prevents display — set it to visible.
  • For documented theme fixes see theme compatibility.
🖼️ Screenshot: example z-index conflict (before/after) img/ts-theme-zindex.png · recommended 1200×500

Translations not applied

Symptom: German appears despite EN/FR/IT texts being entered.

  • Check the URL parameter: the language is controlled via ?lang=en / ?lang=fr / ?lang=it.
  • After every menu change, click Load again in the translation module — new JSON texts must be re-scanned.
  • Mind the import mode: Merge keeps existing keys, Replace overwrites everything.
  • Menu titles (top level) are translated separately in the 🌐 field of the menu editor, not in the module.

Workflow in detail: multilingual (i18n).

After update: old appearance

Symptom: after a plugin update the panel still looks like before.

  • Hard-refresh the browser cache (Ctrl+F5).
  • Clear the page cache plugin (all pages).
  • Purge the CDN cache (Cloudflare etc.) — CSS/JS assets are versioned, but HTML may be cached.
  • With optimization plugins (Autoptimize, WP Rocket): regenerate the aggregated CSS/JS files.

Still having problems?

If none of the above helps, please collect the following information and contact support:

  • Plugin version (Core, Pro if applicable) — see Plugins → Installed Plugins
  • WordPress version and active theme
  • Browser console output (F12 → Console) when opening the menu
  • The JSON of the affected menu item (copy/paste)

Contact support To the documentation

Pro customers receive priority support with a guaranteed response time — more about SuperNav Pro.