Symptoms

Potential Diagnosis

  • jQuery version incorrect

    UberMenu 3.0 requires jQuery 1.11.1 or higher (but less than jQuery v2), which should automatically be included with WordPress 3.9 or higher. If your theme or another plugin has changed the jQuery version, that can cause javascript errors that can break the menu as well as other javascript component on…

  • overflow:hidden; (submenu truncated by theme CSS)

    If the theme is setting overflow:hidden on one of UberMenu’s ancestor elements, it can effectively cut off the submenus, either partially or from displaying at all.

  • z-index (submenu hidden behind content)

    When HTML elements overlap on the page, they have to be layered – one element has to be in front of, and the other behind on the z-axis. The element on the bottom may be hidden by the element on top. If UberMenu appears below other elements on your page,…

  • UberMenu javascript is not loaded

    If a WordPress theme does not include the required hooks (wp_footer), UberMenu can’t load its javascript, so javascript functionality like animations, triggers, and maps will be lost.

  • UberMenu stylesheets not loaded

    If a WordPress theme does not include the required hooks (wp_head), UberMenu can’t load its stylesheets, so the menu won’t be styled.

  • Internet Explorer stylesheet limit reached

    Internet Explorer can only load 31 stylesheets per page. If your theme or another plugin is loading a large number of stylesheets, and the limit is reached before UberMenu’s stylesheets are loaded, UberMenu’s styles will not appear at all in Internet Explorer, because IE has ignored those stylesheets entirely.

  • Residual styling from the theme is affecting the menu display

    If your theme’s menu styles are based on a hard-coded element wrapping the menu, those styles will still apply after replacing the menu markup, and will conflict and negatively impact the style and functionality of the menu.

  • jQuery Enhancements disabled (UberMenu 2 only)

    If you disable jQuery Enhancements, you will lose all javascript functionality in the menu, including animations, maps, non-hover triggers, and the responsive menu toggle expansion.

  • UberMenu stylesheets disabled

    If the basic.css file has been disabled in the Control Panel, the menu will not function properly if the styles have not been included elsewhere.

  • Flash object obstructing menu / submenu

    Because Flash objects are always layered above all other HTML elements, if they overlap with your submenu, the submenu will be partially obstructed.