Header States
Inside a Header Navigation template, one set of blocks can look different in each header state. The header restyles itself as the visitor scrolls or opens the menu, without duplicating any blocks. You edit the header once, give each state the styling you want, and Nectarblocks switches between them on the front end.
The states
- Default: the baseline appearance, used whenever no other state applies.
- Transparent: the header sitting over the top of the page, typically over a hero, before the visitor scrolls.
- Scrolled: the appearance once the visitor scrolls down from the top of the page.
- Overlay Menu: the appearance while a fullscreen off canvas menu is open.
You can also create your own color variants, which the header switches to while particular sections of a page are behind it.
When each state applies
Transparent only applies on pages that use a transparent header. Two settings control that:
- Turn on Transparent Header in Appearance → Customize → Header Navigation → Transparent Header Effect. This is the master switch. While it's off, no page gets a transparent header.
- Choose where it applies. Automatically Enable On, in the same Customizer section, turns it on for whole post types and archives. For a single page, turn on Transparent Header under Nectarblocks Post Options in the page's sidebar.
On pages without a transparent header, the theme reserves the header's height at the top of the page, so content starts below the header. On transparent pages, the header sits over the content instead.
Scrolled takes over as soon as the visitor scrolls down from the top, on every page. Scrolling back to the top returns the header to Default or Transparent.
Overlay Menu applies while the off canvas menu is open, when its Style (Appearance → Customize → Header Navigation → Header Off Canvas Menu) is one of the fullscreen options. With Slide Out From Side, the panel slides in over the page and the header keeps its current state. See Off Canvas Menu.
The same Nectarblocks Post Options panel has a Header Animation option, which plays an entrance effect on the header when that page loads.

Editing a state
The Header State picker sits in the editor toolbar next to the device buttons.
- Open the picker and choose a Lifecycle state, for example Scrolled.
- The canvas shows the header in that state, so you see your changes as if it were active.
- Change any state-aware control. The value applies only to that state and overrides the Default value there.
- Switch back to Default to edit the baseline, or pick another state to style it.
To undo a single override, click the reset icon next to the control's label. To clear everything you've set for the current state, click Reset next to the picker.
Editor canvas sets the background shown behind the header while you edit that state (Light, Dark or a custom Color). It only affects the editor, so you can design a transparent header against a dark hero, for example. Transparent starts on Dark.

While a state other than Default is selected, the labels of state-aware controls change color:
- Green: the control can be set for this state and currently uses the Default value.
- Purple with a reset icon: the control has its own value in this state.
Labels that stay black can't change per state.

Unlike the responsive waterfall, where desktop values flow down to tablet and mobile, a state value is either set or not. When it's set, it applies in that state and overrides the Default value. There is no inheritance between states.
State-aware controls
These controls can be set per state:
- Colors: background, text and icon colors, the Navigation block's dropdown colors, and the Search block's colors
- Spacing (padding and margin)
- Border and Border Radius
- Size
- Display
- Effects and Transform
Everything else, including Position, Overflow, font styles and sizes, images, and the Navigation block's Overlay tab, is shared by all states.
That's enough to change the header's layout between states: shrink the padding on scroll, hide a row, or flip to light colors while transparent over a dark hero.
Transition
The Transition panel in the template's sidebar (the Template tab) controls how the header animates between states and variants:
- Duration:
0.05to1.5seconds. The default is0.55. - Easing: the curve the change follows.

Color variants
Color variants are named header looks, such as "Dark" or "Cream", that the header switches to while a tagged section of the page is behind it. A light page with one dark section can flip the header to light text only while that section passes under it.
A variant can change the same controls as a state, not only colors.
Creating and styling a variant
- Open the Header State picker and click Add Variant under Variant. Give it a name.
- Select the variant in the picker and style the header the same way you style a state. You can also choose a lifecycle state at the same time, for example to style how the variant looks once scrolled.
- Use the variant's menu in the picker to rename or delete it, and drag variants to reorder them. Deleting a variant removes its values from the header.
Tagging a section
In the page editor, select a top-level Row and open its Header Appearance panel. Set Variant to the look the header should use while that section is behind it.
The panel only appears with the Nectarblocks theme, once your header has at least one variant, and on Rows that aren't nested inside another Row.

On the front end, the header uses the variant of whichever tagged section sits under its bottom edge, and goes back to normal over untagged sections. If the first tagged section is visible when the page loads, its variant applies right away. While the overlay menu is open, the Overlay Menu state takes priority.
Recipes
Show a different logo in a state
The Image block can't change its image per state, so use two logos and show one at a time. A common case is a light logo while the header is transparent over a dark hero.
- Wrap each logo's Image block in its own Flex Box, side by side where the logo sits.
- Select the Flex Box holding the light logo and set Display to None in the Default state.
- Switch to the Transparent state. On the light logo's Flex Box, set Display to Flex. On the dark logo's Flex Box, set Display to None.
Repeat step 3 in any other state that should use the light logo, such as Overlay Menu.
Hide a top bar once the header scrolls
- Add a Row above your menu row and put the top bar's content in it.
- Switch to the Scrolled state, select the new Row and set Display to None.
- Still in Scrolled, switch the editor to Tablet and set Display to None again. Rows keep their own tablet display setting, so without this step the bar stays visible on tablets and phones after scrolling.
The bar disappears as soon as the page scrolls, and the menu row stays at the top.
Change a button once the header scrolls
Select the button, switch to the Scrolled state and change its background and text colors. The button keeps its Default colors at the top of the page and switches when the visitor scrolls.
Related
- Header Builder: create and manage the Header Navigation template.
- Off Canvas Menu: build the panel the header's menu button opens.
- Transparent Header Effect: the Customizer settings that turn on the Transparent state.
- Hover Mode: the other place stateful editing appears, for hover styling outside the header.