Skip to main content

Header Builder

The Header Builder is the experience of editing a Header Navigation template in the Theme Builder. Instead of a fixed set of header options, you assemble your header from blocks — giving you full control over its layout, content and styling, including how it looks before and after scrolling.

Replacing the classic header​

When a Header Navigation template is assigned in the Theme Builder, it completely replaces the classic theme header. The header is now built entirely with blocks, and the classic navigation no longer renders.

The Theme Customizer reflects this. Its header sections show a "Header Builder Active" notice and only list the settings that still apply (see What the Customizer still controls). Everything else about the header is edited in the block editor.

Header Builder Active notice in the Theme Customizer

To bring the classic navigation back, delete the Header Navigation template or unassign it from the header navigation location in the Theme Builder. The classic header returns with the full set of Customizer options. Nothing is lost, so you can switch between the two at any time.

A Header Navigation template can also be limited to certain pages with display conditions. Pages it doesn't match keep the classic header. See Display conditions.

What the Customizer still controls​

With a Header Navigation template active, these settings in Appearance → Customize → Header Navigation still apply:

  • Logo & General Styling: Remove Desktop Stickiness, which lets the header scroll away with the page on desktop instead of staying at the top.
  • Transparent Header Effect: Transparent Header and Automatically Enable On, which turn on the header's Transparent state. See Header States.
  • Animation Effects: Header Hide Until Needed, which hides the header as the visitor scrolls down and brings it back when they scroll up.
  • Dropdowns: Add Background Overlay and Background Blur, which dim and blur the page while a dropdown or megamenu is open.
  • Header Off Canvas Menu: the style and size of the panel the menu button opens. See Off Canvas Menu.
  • Mobile Menu: Header Sticky On Mobile, on by default, which keeps the header at the top of the screen on mobile.
  • Header Color Scheme: the off canvas panel's colors. This section only appears once a published Off Canvas Menu template exists.

The other header settings, such as logos, the secondary header bar, header search and the mobile breakpoint, belong to the classic header. With the Header Builder you build those parts in the template instead.

Header Navigation panel in the Customizer listing the sections that remain with the Header Builder

Screen sizes​

The Header Builder uses fixed breakpoints, and the classic Header Mobile Breakpoint setting doesn't apply:

  • Desktop: 1025px and wider
  • Tablet: 768px to 1024px
  • Mobile: 767px and narrower

The Navigation block's Overlay tab decides at which of these sizes the menu button replaces the links. Only Mobile uses it by default. See Navigation.

Creating a Header Navigation template​

Start from the Theme Builder:

  1. In the WordPress admin, open Theme Builder.
  2. Click Add New Template to open the template chooser.
  3. Under the Navigation group, choose Header Navigation.
  4. Click Create Template.
Header Navigation template open in the editor with the Header State picker in the toolbar

The template opens in the block editor pre-populated with a working default header, so you have a starting point rather than a blank canvas.

Start from a pre-built layout

Prefer to start from a design? The Template Library includes a Navigation category with example header layouts you can insert and then adjust to your brand.

Composing the header​

Assemble the header from the header blocks:

  • Navigation — your menu, wrapping the core WordPress Navigation block. Add Megamenu blocks inside menu items for rich dropdowns.
  • Header Actions — a container for your action icons: Search, a Header Account link, and the WooCommerce Mini Cart.

Standard layout blocks (Row, Column, Flex Box, Image for your logo, etc.) arrange everything.

To turn a Global Section into a megamenu and choose how wide it opens, see Building a Megamenu.

Header states​

A header often needs to look different depending on what the visitor is doing — sitting transparent over a hero, condensing once the page scrolls, or restyling while an overlay menu is open. The Header Builder handles this with four built-in states — Default, Transparent, Scrolled and Overlay Menu — plus your own named color variants. You style each state once from the same blocks, and the header transitions between them automatically on the front end.

See Header States for the full editing workflow: the Header State picker, which controls can be overridden per state, and how color variants work.

To design the panel that opens from the header's menu button, see Off Canvas Menu.