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,…

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

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

  • Unrelated javascript error

    If another plugin or your theme throws a javascript error before UberMenu’s javascript has been executed, it will prevent UberMenu from functioning properly, including submenu positioning, click events, responsive menu toggling, and more.

  • Submenus hidden in Internet Explorer with Filter Gradient

    You can NOT use IE gradient filters on your menu bar. If you add an IE filter to your menu bar in order to create a gradient, IE will automatically treat that element as overflow:hidden, no matter what CSS settings you change. This effectively chops off the submenu and prevents…

  • Residual scripting from the theme

    Some themes’ menu javascript will still affect the menu even after UberMenu has replaced the default menu. As a result, UberMenu can appear distorted, the styles can be incorrect, extra markup may be added, and the functionality may break.