Skip to main content
Documentation/Elements & Controls Reference/Elements/Site/WP Menu

WP Menu

WP Menu displays navigation maintained in WordPress. Use Menu Builder for navigation built from Breakdance elements.

Select a Menu

  1. Create and save a menu under Appearance > Menus, arranging links and their nesting.
  2. Add WP Menu to your page or header, then choose Content > Menu > Menu.
  3. Configure Design > Desktop Menu and Mobile Menu, then save.

Edit item order in WordPress; WP Menu has no children in Structure. Reopen the chooser if a newly saved menu is missing. Changes to the WordPress menu update all instances using it; each instance can have its own styling. When used in a header, the header’s conditions determine where it appears.

Mobile Presentation

Set Mobile Menu > Show At, then choose Default, Fullscreen, or Offcanvas under Mode. Fullscreen/Offcanvas expose top-bar settings; Offcanvas adds width and left/right placement. Configure links and toggle states here.

Use Content > Menu > Accessibility > Attributes for Name/Value pairs, such as aria-label and Footer navigation.

WP Menu with Docs Navigation selected in the Menu chooser
WP Menu with Docs Navigation selected in the Menu chooser

Controls

Responsive varies by breakpoint; Hover has a hover value; Shared applies across both. In conditions, = means “is” and ≠ means “is not.”

Content > Menu

Setting Purpose and options Behavior
Menu Choose an available menu from the list. Shared
Accessibility > Attributes Add attribute name and value pairs. Shared
Accessibility > Attributes > Name Attribute name. Shared
Accessibility > Attributes > Value Attribute value. Shared

Design > Desktop Menu

Setting Purpose and options Behavior
Links > Typography typography controls. See linked controls
Links > Effect > Effect Type Underline, Overline, Strikethrough, Background. Shared
Links > Effect > Effect Direction None, Left, Center, Right, Top, Bottom. When: Effect Type ≠ none. Shared
Links > Effect > Thickness Thickness and unit. When: Effect Type = Overline, Underline, Strikethrough. Shared
Links > Effect > Color Color or supported fill. Shared
Links > Effect > Radius Set the corner radius. When: Effect Type = Background. Shared
Links > Active > Effect Type Underline, Overline, Strikethrough, Background. Shared
Links > Active > Thickness Thickness and unit. When: Effect Type = Overline, Underline, Strikethrough. Shared
Links > Active > Color Color or supported fill. When: Effect Type is set. Shared
Links > Active > Radius Set the corner radius. When: Effect Type = Background. Shared
Links > Active > Text Color Color or supported fill. Shared
Links > Size spacing controls. See linked controls
Links > Space Between Space between and unit. Responsive
Links > Dropdown Arrows > Disable On/off. Shared
Links > Dropdown Arrows > Color Color or supported fill. Hover
Links > Dropdown Arrows > Size Size and unit. Shared
Links > Dropdown Arrows > Gap Space between items. Shared
Links > Dropdown Arrows > Offset Offset and unit. Shared
Links > Dropdown Arrows > Closed Rotation Closed rotation and unit. Shared
Links > Dropdown Arrows > Open Rotation Open rotation and unit. Shared
Links > Dropdown Arrows > Custom Arrow Icon. Shared
Dropdowns > Wrapper > Background Color or supported fill. Shared
Dropdowns > Wrapper > Padding spacing controls. See linked controls
Dropdowns > Wrapper > Borders borders controls. See linked controls
Dropdowns > Wrapper > Placement Left, Center, Right, Full Width, Section Width. When: Vertical is unset or Vertical Mode ≠ Accordion. Shared
Dropdowns > Wrapper > Width Set width. Range: 100–1140. When: Placement ≠ Section Width, Full Width. Shared
Dropdowns > Wrapper > Caret Radius Caret radius and unit. When: Vertical is unset or Vertical Mode ≠ Accordion, Side. Shared
Dropdowns > Wrapper > Disable Caret On/off. When: Vertical is unset or Vertical Mode ≠ Accordion, Side. Shared
Dropdowns > Wrapper > Offset Offset and unit. When: Vertical Mode ≠ Accordion and Vertical is set or Vertical is unset. Shared
Dropdowns > Wrapper > Animation None, Fade, Stripe, Skew, Rotate, Scale Down, Scale Down Right. When: Vertical is unset and Vertical Mode ≠ Accordion. Shared
Dropdowns > Wrapper > Transition Duration Transition duration. Shared
Dropdowns > Links > Title typography controls. See linked controls
Dropdowns > Links > Spacing > Between Links Between links and unit. Shared
Dropdowns > Links > Padding spacing controls. See linked controls
Dropdowns > Links > Radius Set the corner radius. Shared
Dropdowns > Links > Hover Background Color or supported fill. Shared
Dropdowns > Open Dropdowns on Click On/off. Shared
Transition Duration Transition duration. Shared
Vertical On/off. Shared
Vertical Mode Dropdown, Accordion, Side. When: Vertical is set. Shared
Alignment Left, Center, Right. When: Vertical is set. Shared

Design > Mobile Menu

Setting Purpose and options Behavior
Show At Breakpoint. Shared
Mode Default, Fullscreen, Offcanvas. Shared
Offcanvas Width Offcanvas width and unit. When: Mode = Offcanvas. Shared
Offcanvas Position Left, Right. When: Mode = Offcanvas. Shared
Top Bar > Logo WordPress media. When: Mode = Offcanvas, Fullscreen. Shared

Shown when Mode = Offcanvas, Fullscreen and Logo is set.

Setting Purpose and options Behavior
Top Bar > Logo Width Logo width and unit. Responsive
Top Bar > Logo On Right On/off. Shared
Top Bar > Logo URL Set logo url. Shared
Top Bar > Logo Alt > Alt Disable, Custom. Shared
Setting Purpose and options Behavior
Top Bar > Logo Alt > Custom Alt Alternative text describing the image. When: Mode = Offcanvas, Fullscreen and Logo is set and Alt = Custom. Shared

Shown when Mode = Offcanvas, Fullscreen.

Setting Purpose and options Behavior
Top Bar > Padding Padding. Shared
Top Bar > Close Button > Disable On/off. Shared
Top Bar > Close Button > Color Color or supported fill. Hover
Top Bar > Close Button > Size Size and unit. Shared
Top Bar > Close Button > Bar Height Bar height and unit. Shared
Setting Purpose and options Behavior
Vertically Align Center On/off. When: Mode = Fullscreen, Offcanvas. Shared
Offset Offset and unit. When: Mode ≠ Fullscreen, Offcanvas. Shared
Links > Background Color or supported fill. Hover
Links > No Border On/off. Shared
Links > Border Color or supported fill. When: No Border is unset. Shared
Links > Typography > Level 1 typography controls. See linked controls
Links > Typography > Level 2 typography controls. See linked controls
Links > Active > Color Color or supported fill. Shared
Links > Active > Background Color or supported fill. Shared
Links > Padding > Level 1 Set the spacing on each side. Shared
Links > Padding > Level 2 Set the spacing on each side. Shared
Links > Dropdowns > Hide Link Graphic On/off. When: Dropdowns Like Desktop is set. Shared
Links > Dropdowns > Hide Link Description On/off. When: Dropdowns Like Desktop is set. Shared
Links > Dropdown Arrows > Disable On/off. Shared
Links > Dropdown Arrows > Color Color or supported fill. Hover
Links > Dropdown Arrows > Size Size and unit. Shared
Links > Dropdown Arrows > Gap Space between items. Shared
Links > Dropdown Arrows > Offset Offset and unit. Shared
Links > Dropdown Arrows > Closed Rotation Closed rotation and unit. Shared
Links > Dropdown Arrows > Open Rotation Open rotation and unit. Shared
Links > Dropdown Arrows > Custom Arrow Icon. Shared
Links > Horizontally Center Links On/off. Shared
Toggle > Icon Color or supported fill. Hover
Toggle > Icon Open Color or supported fill. Shared
Toggle > Wrapper Color or supported fill. Hover
Toggle > Wrapper Open Color or supported fill. Shared
Toggle > Wrapper Padding > Padding Padding. Shared
Toggle > Wrapper Radius Wrapper radius and unit. Shared
Toggle > Animation Disabled, None, Arrow, Collapse, Elastic, Emphatic, Minus, Slider, Spin, Spring, Squeeze, Stand, Vortex, 3DX, 3DXY, 3DY. Shared
Toggle > Custom Icon > Bar Width Bar width and unit. Shared
Toggle > Custom Icon > Bar Height Bar height and unit. Shared
Toggle > Custom Icon > Bar Spacing Bar spacing and unit. Shared
Toggle > Custom Icon > Bar Radius Bar radius and unit. Shared
Toggle > Custom Icon > Open Icon Icon. Shared
Toggle > Custom Icon > Close Icon Icon. When: Open Icon is set. Shared
Background Color or supported fill. Shared
Transition Duration Transition duration. Shared

Design > Spacing

Setting Purpose and options Behavior
Spacing spacing controls. See linked controls