Accordion Menu

Display a hierarchical WordPress menu or taxonomy as an expandable vertical navigation. Use it for sidebars, category trees, or nested navigation inside a popup or panel.

Setup and First Use


Before starting, enable the relevant element or feature family under Bricks → BricksUltimate → General Elements, save, and reopen the Bricks editor. Integrations also require their corresponding plugin to be active.

  1. Create a WordPress menu with genuinely nested child items, or create parent and child terms in a hierarchical taxonomy.
  2. Add (BU)Accordion Menu and select WP Menu or Taxonomy under Source.
  3. Choose the menu or taxonomy, then configure source-specific filtering.
  4. Enable accordion effect and decide whether top-level items should always remain visible.
  5. Style menu name, top-level links, sub-menu items, current-item states, and toggle icons.
  6. Open the live page and test every nesting level and the currently selected destination.

Controls and Settings


ControlPurpose and usage
Source / WP MenuReads the saved menu structure. Edit labels, URLs, hierarchy, and item order in WordPress.
TaxonomyReads terms from the selected taxonomy rather than a menu assignment.
Include / Exclude termsUse comma-separated term IDs; these filters are relevant to the taxonomy source.
Hide empty terms? / Child of / LimitControl empty terms, restrict to a parent hierarchy, and limit the query. Test with real assigned content.
Order by / OrderSort taxonomy results by the available keys, for example Name or Include. WordPress-menu hierarchy comes from the saved menu.
Accordion controlsEnable expansion, set slide transition duration, and choose top-level visibility.
Menu Items / Sub Menu Items / Toggle IconStyle link states, sub-item indent, icon color/size/rotation, and hover animation.

Taxonomy Navigation Is Not AJAX Filtering


Term links navigate to term destinations. The element does not turn those links into live grid filters. For faceted filtering, use WP Grid Builder and its appropriate integration. A non-hierarchical taxonomy may not provide useful expandable branches.

Design and Interaction


Use indentation and a visible toggle to distinguish parent items from leaf links. Keep current-item colors readable and avoid relying only on color. Test link navigation separately from branch expansion; an empty or flat menu cannot demonstrate the accordion behavior.

Practical Example


Build a product category sidebar with Source set to Taxonomy and product categories selected. Keep child terms nested under their parents, hide empty terms, and use a small chevron for expansion.

Troubleshooting


  • No submenu appears: confirm the source actually contains children and accordion effect is enabled.
  • Missing categories: review Hide empty terms, Child of, Include/Exclude IDs, and the limit.
  • Wrong destination or hierarchy: correct the menu or taxonomy data, not the typography controls.

Related Documentation