Navigation, Header & Footer
Pick a premium header template and layout variant, build your top navigation and mega-menus, configure your footer columns and payment icons, and set how the menu behaves on mobile.
Your header and footer appear on every page of your store, so they're worth setting up carefully. Both have their own dedicated editor with a live preview of how they'll look on desktop and mobile.
Screen: Online Store → Theme → Page Layouts, then open Header or Footer from the journey rail. Both editors show a live mock of the header or footer in context.
Before you publish anything: premium defaults, not a blank chrome
If you've never published a Header or Footer design, your store doesn't show a bare, unstyled navbar and footer — since the 2026-07-12 premium-by-default rollout it automatically renders a premium default instead: a centered logo, split navigation header and a centered minimal luxury footer, both built from your real branding (logo, store name, and navigation links) rather than placeholder content. This also applies if your store's saved header/footer design ever fails to load. Publishing your own Header or Footer design here replaces the default immediately and permanently for that surface — there's no way to intentionally revert to the automatic default once you've published something.
Utility Bar, Header Navbar, and Header Appearance edits update the canvas live; Announcement edits wait for Save Draft
Editing a field on the Utility Bar, Header Navbar, or Header Appearance panel updates this editor's own live preview canvas as you type, the same as editing a page section — you don't need to reload the editor to see the draft reflected here. While the storefront frame catches up, the canvas shows Updating preview…. This is a preview-sync state, not proof that the draft reached the server: after checking the canvas, select the top-bar Save status action. It changes to Saving…, then to the saved/publish state when the request finishes. If it becomes Retry, the draft is still in the editor; select Retry (or the Retry action in the error toast) to send it again.
The Announcement Bar row is the exception: most of its fields are held in your draft until you select Save Draft, and customers see nothing until you publish. See Announcement row: draft saving, button, and background image.
Premium header templates and layout variants
Your header has two separate configuration surfaces that work together:
- The template gallery (this section) — picks the header's overall structure (one of 11 templates) via a switcher, and its look (a colour/theme recipe for that structure) via a drawer next to a live preview of your storefront header that stays visible the whole time you're browsing.
- The classic Header editor (Desktop / Mobile / Shared modes, described below) — your navigation links, mega-menus, colours, and mobile behaviour. Whichever template and arrangement you pick still renders your logo, navigation links, and brand colours from here — the template gallery changes the shape and skin, not the content.
Screen: Online Store → Theme → Page Layouts → Header, or click Browse Templates from inside the classic Header editor's Desktop mode.
The structure sidebar and the template gallery
Opening Header (or Footer) shows a narrow sidebar on the left. At the top is your current template's colour swatch, then its name as a clickable button with a small dropdown arrow — this is the structure switcher. Below it sits a Templates › link, then your header's bands/tiers, and a pinned Theme Settings entry — the same Content / Features / Advanced controls the old Config tab held (see the table below), just reached from this sidebar instead of a tab strip. Your live storefront preview fills the rest of the screen throughout.
Structure and look are now two separate controls
Earlier versions of this screen bundled structure (which of the 11 header designs) and look (its colour/theme recipe) into one Change template › gallery, with Presets and a scrollable Template list. That's now split in two: click the template name at the top of the sidebar to change structure — it commits immediately, no gallery needed. Click Templates › below it to change look — that still opens a drawer, now showing only look cards for whichever structure is currently active.
Guided setup — answer a few questions instead of building the structure by hand
Next to Templates › at the top of the Header sidebar is a Guided setup › launcher. It walks you through the same structure/tier decisions as the sidebar itself, as a short multi-step dialog: Orientation (horizontal bar or vertical rail — this filters which structures show up next), Structure (a card grid of the matching header designs), Rows (Header Navbar is always on; tick Announcement, Utility Bar, and/or Sub-nav if your chosen structure supports them — an unsupported row's checkbox does nothing, it's never shown-and-broken), Zones (a read-only summary of the Start / Center / End content each row will have), and Finish, which offers Customize navigation items — click it and you land directly on the Header Navbar's real content editor with your rows already in place, ready to add links. It doesn't add any capability the sidebar itself doesn't have; it's a faster on-ramp through the same structure/tier/zone controls described in this section, for when you'd rather answer a short sequence of questions than explore the sidebar tree yourself.
Changing structure. Click the template name (with the dropdown arrow) to open a menu listing all 11 header designs (7 for Footer). Selecting one applies immediately — there's no staging step and no Apply button for this control, so your live preview and your saved structure update together the moment you click. Locked (unpaid-plan) designs show a lock icon and can't be selected; on the v2 theme, unlocked flagship designs additionally show a Flagship pill.
Switching structure can replace custom bands/tiers
If your current header has extra tiers (or your footer has extra bands) and you pick a structure that doesn't support them, the menu badges that option "Replaces custom layout" instead of switching immediately. Clicking it opens an inline confirm — "Switching to — this template doesn't support additional header tiers; your tier(s) will be replaced by its default layout" (footer's wording is the band equivalent) — with Switch (commit the change and lose the custom tiers/bands) and Keep current (dismiss, nothing changes) buttons. A structure switch that doesn't touch your tiers/bands never shows this — it applies straight away like any other option.
Removing a row (tier). Every row in the sidebar tree except Header Navbar (Announcement, Utility Bar, Sub-nav) has its own trash icon. Clicking it doesn't remove the row immediately — it swaps the icon for a confirm/cancel pair; click the checkmark to actually remove the row, or the cancel icon to back out and keep it. Header Navbar has no trash icon at all — it can't be removed, on any template.
Hiding a row (tier) without removing it. Next to the trash icon, every row except Header Navbar also has a Show / Hide eye toggle — the same show/hide control used on ordinary page sections. Click it to hide the row instead of deleting it: the row stays in your structure tree (dimmed, so you can tell at a glance it's hidden) with all of its saved content intact, and clicking the toggle again brings it straight back with nothing to re-enter. Header Navbar can never be hidden this way, on any template — it's always shown.
Hiding a tier now removes it from the published storefront, not just the editor preview
Hiding an Announcement or Utility Bar row (or Sub-nav, where supported) omits that row from both the editor's live preview and the published storefront header once you Save and Publish — a customer never sees a hidden row's content. Showing it again and re-publishing brings it back on the storefront the same way. If a header still shows a row you hid, confirm you clicked Save and, on a premium template, Publish, then hard-refresh the storefront.
Optional rows on an older header appear when you use their controls
A converted older header may list a supported Announcement or Utility Bar row even though that row has not been written into its saved structure yet. This is a safe placeholder: merely opening the Header editor does not add the row or change the storefront. Use the row's Show eye, Reset row, desktop/mobile visibility menu, or reorder control to create it; a newly materialised row begins hidden until you explicitly show or reset it. Existing Announcement or Utility Bar copy is preserved. Header Navbar remains required, and a row the selected template does not support stays unavailable instead of being created.
If you navigate away with unsaved edits
The Header (and Footer) page editor warns you before you lose work: if you've made an edit that hasn't been saved yet and you try to reload or close the browser tab, your browser shows its native "Leave site? Changes you made may not be saved" prompt. This only guards against reloading or closing the tab. Links, buttons, and forms inside the canvas never navigate the preview: clicking one selects the part it belongs to instead (for example, clicking Sign Up selects the Header), so you cannot accidentally leave the page you are editing from inside the canvas.
Adding blocks to a header row
A row you've added (or a native row your template already had) can carry extra content blocks. Select the row, open Content, then use Add block in its Start, Center, or End zone. Blocks render alongside the row's built-in content by default. To replace that built-in content instead, open Design and turn off Keep this row's built-in layout. Removing every block returns the row to its plain built-in layout automatically.
On the Header Navbar row, adding a block for something the header already shows (Search, Cart, Account, Wishlist) moves it rather than duplicating it. See Built-in items move when you add them.
Showing a block on mobile or desktop
Blocks you add to a header row are hidden on mobile by default and shown on desktop. You decide per block, so a long block can stay desktop-only while a small one shows on phones too.
Open the block
Select the row (for example Header Navbar) and open Content. In the block's Start, Center, or End zone, click Edit on the block.
Use the two switches
At the bottom of the block's settings you will find Show on desktop and Show on mobile. Show on desktop is on unless you turn it off. Show on mobile is off until you turn it on; the line Hidden on mobile by default under the switches reminds you of this.
Check the Outline
A block that is hidden on mobile shows a small phone indicator (tooltip Hidden on mobile) in the structure tree. Turning Show on mobile on removes it. Save, and on a premium template Publish, for the storefront to pick it up.
These switches apply to blocks you added. The built-in logo, navigation, and search are not governed by them. Whole rows have their own mobile control: the row's menu in the structure tree offers Hide on mobile or Show on mobile (and the same for desktop).
Featured Products on phones
For the Featured Products block, Show on mobile works differently, because its product tiles are too tall for the slim phone top bar. With Show on mobile on, the tiles appear inside the mobile menu (tap the menu button to open it), not in the top bar. With it off (the default) the block is hidden on phones. Desktop is unchanged.
Why doesn't my block show on mobile?
New header blocks start hidden on mobile. Open the block under Content and turn Show on mobile on, then save (and publish) and check the storefront on a phone-width screen. If it is still missing, check that the row itself is not set to Hide on mobile in its menu, and that you did not only change Show on desktop. Built-in items such as the logo, navigation, and search ignore these switches; manage them from their own settings.
Why don't customers see Featured Products on phones? Either Show on mobile is off on that block (the default), or it is on and the tiles are inside the mobile menu: tap the menu button to find them, they never appear in the top bar.
Add Cart, Account, or Wishlist to a header row
The Header editor's Add block dialog lists these as three separate choices in its Commerce group. It no longer offers one combined Cart & account icons choice when you add a new block.
Open the Header editor
Go to Online Store → Theme → Page Layouts → Header. Select Header Navbar in the structure tree, or select another header row that offers commerce-icon blocks.
Choose the row zone
Open Content. Under Start, Center, or End, select Add block for the zone where you want the shortcut to appear.
Add one commerce shortcut
In Commerce, choose the entry you need:
| Entry | What it adds for customers |
|---|---|
| Cart | A cart shortcut with an optional item count |
| Account | An account or sign-in shortcut |
| Wishlist | A wishlist shortcut with an optional item count |
Repeat Add block if you need another one. Each choice adds only that shortcut; it does not add the other two automatically.
Check the matching visibility switches
Adding the block does not change its existing Theme Settings or Store Branding visibility switches. Check the matching controls described below before publishing.
Save and publish the Header
Select Save Draft to keep the change in the editor, then Publish when you want customers to receive it. On the storefront, the new block appears as the selected cart, account/sign-in, or wishlist shortcut when that action is also enabled by the visibility controls below.
Existing combined icon blocks do not change
If your Header was saved before these separate entries were introduced, its existing combined cart, account, and wishlist icons block stays combined. The split changes the choices for newly added blocks; it does not rewrite the block already saved in your Header.
Open an icons block to change what it shows
Select the block under Header Navbar → Content (Start, Center, or End zone). Its settings show a Show list with one on/off switch per icon, plus Cart affordance (Item count, Mini preview, or Opens drawer) when the cart icon is part of the block.
- A block that holds a single icon (for example a block added as only Cart) shows only that icon's switch. The other two icons are not listed, because they belong to other blocks.
- A block that holds several icons (an older combined block) shows a switch for each of cart, account, and wishlist.
- Cart affordance appears only when the block includes the cart.
If you expect a switch for an icon and it is missing, that icon is probably its own separate block in another zone; open that block instead.
Adding a block does not override icon visibility
The new block and the existing visibility switches work together. Show Cart Icon, Show Wishlist Icon, and Show Account Menu under Theme Settings → Features still control their matching actions, as do the Store Branding switches Show Cart Icon, Show Wishlist Icon, and Show User Menu. If either matching switch hides an action, adding its block does not force it onto the published storefront.
I can't find Cart & account icons any more
That combined entry is no longer offered for new blocks. In Add block → Commerce, choose Cart, Account, or Wishlist separately and repeat the action for every shortcut you need. If none of those entries appears, the selected row or layout does not offer the underlying commerce-icons block; select a compatible Header row, such as Header Navbar, and open its Add block dialog instead. Existing combined blocks keep their saved shape and do not need to be replaced.
Jumping between Theme Settings groups without backing all the way out
Inside Theme Settings, whichever group you're viewing (Content, Layout, Page Style, and so on) shows the other groups as small clickable chips at the top of the panel — click one to jump straight there instead of using the small breadcrumb text or back arrow to return to the group list first. Layout — holding the header's spacing/nav axes and the Mega Panel Width control described below — is reachable from any other group in one click this way.
Finding Header and Footer controls by task
In the current Store Editor, the right inspector groups Header and Footer controls by what you are trying to change. Select the Header, Footer, a row, or one of its blocks, then choose the relevant Content, Design, or Behaviour lens:
| Lens | Task groups you may see |
|---|---|
| Content | Text & media, Accessibility |
| Design | Colors, Typography, Layout, Spacing & sizing, Shape & borders, Effects, Advanced |
| Behaviour | Sticky & scroll, Mobile |
Only groups that apply to the selected subject are shown. Open a group to reach its controls; opening another group in the same panel closes the first, and the editor remembers your open group for that panel and lens during the current session. Nested Header and Footer panels use these same task names, so look under Layout rather than “Slot layout”, and Spacing & sizing or Colors rather than the retired “Spacing & Appearance” or standalone “Appearance” headings.
Use Search this block's controls when you know the outcome but not the group. Merchant terms such as “background”, “font”, “sticky”, “cart”, or “mobile” match both control labels and the task group's related terms. N changed filters the current lens to edited controls; it is disabled when that lens has no changes. On narrow windows, compound inputs wrap inside the inspector instead of creating a horizontal scrollbar, so do not drag the panel sideways to look for a clipped label.
A control is missing from the group you opened
First check the selected Header/Footer subject and the active lens. Search is scoped to that lens, and templates hide controls they cannot use. Clear the search and N changed filter, select the specific row or block again, then try the task's other lens; for example, the logo image/name is under Content, logo size is under Design, and Show tagline is under Behaviour.
Changing look. Click Templates › to open the gallery drawer. It shows one section, headed Templates, of look cards — colour/theme recipes for the structure you currently have active; switching structure first changes which cards you see here. It has:
| Part | What it does |
|---|---|
| Look cards | One card per look available for your current structure. Clicking a card stages it — your live preview updates right away and stays on that look until you Apply, click another card, or leave the drawer |
| Back / Apply (drawer header) | Back, or pressing Esc, discards whatever's staged and restores your last-applied look. Apply commits the staged look — greyed out until you've staged something. Applying does not publish; see Save Draft vs. Publish below |
Exactly one card shows the Selected badge at a time. Hovering a card (or, on touch devices, its preview affordance) shows a Previewing badge and briefly swaps your live preview to that look without staging it; moving away restores whatever was staged before (or your published choice, if nothing is staged yet).
For the Header specifically, each look card in this drawer renders a real, live miniature of that look — not a flat colour swatch — composited over a photographic hero background, so you're judging the look the way it will actually sit above your homepage's hero image rather than in isolation on a blank card.
Clicking previews AND stages — hovering only previews
Clicking a look card updates your live preview immediately and keeps it there — even after you move your mouse away — until you click another card, hit Apply, or leave the drawer. Hovering without clicking only shows a temporary preview that reverts the moment you stop hovering. If you're unsure whether you've staged something or are just previewing, check the badge: a hover-only preview shows Previewing, never Selected.
Theme Settings (the old Config tab) still applies here
The Theme Settings entry in the sidebar holds the same controls the picker's Config tab used to — Content (button labels, search placeholder, and other chrome strings for the selected template), Features (toggle search, mega-menus, and the commerce icons below), and, under Advanced, colour overrides where available. Switching structure or look does not change these — they carry over regardless of which design you land on.
Moving a store off its original (legacy) header or footer
A store created before the template picker existed can still be on its original layout, which belongs to no template. The sidebar for such a header shows Header rows unavailable and the line "This header keeps its original layout." Nothing is broken: the storefront keeps rendering that header as it always has.
To move to a template:
- Open the Store Editor, choose the Header (or Footer) and click Templates ›. The drawer is titled Change template.
- Read the notice at the top of the Templates section: "Your header uses its original layout. Pick a template and press Apply to switch. Until then your storefront keeps its current header." For the footer it reads "Your footer uses its original layout. Pick a template and press Apply to switch. Until then your storefront keeps its current footer."
- Below the notice, structure chips (when more than one structure is available) and look cards appear. Because your original layout is not one of them, the drawer opens on the first structure so you have something to browse. Click another chip to see that structure's looks.
- Click a look card to stage it. The live preview shows it, but nothing is applied yet.
- Click Apply. Back (or
Esc) leaves without switching and your original layout stays. - Apply does not publish: it changes your draft only. The storefront changes after you Publish.
Opening the drawer, browsing chips, hovering cards or saving other edits never switches the layout; only Apply does.
Preview says No header template registered?
While a header is still on its original layout, the editor preview may show "No header template registered for id: legacy" instead of drawing it. This affects the preview only: your live storefront is unaffected and still shows your original header. Applying a template removes the message.
The 11 templates: Floating Pill Navbar, Two Tier Utility Bar, Centered Logo Split Nav, Tech SaaS Bar (a SaaS-dashboard-style bar), Serif Luxury Bar, Minimal Hamburger Bar, Retro Arcade Bar, Transparent Overlay, Side Rail, Masthead, and Dept Store.
Masthead and Dept Store — the two newest header designs
Both are three-tier structures (a slim utility strip, a main identity row, and a navigation ribbon below it) rather than the single-row bar the other 9 templates use. Masthead is a logo-dominant, editorial layout — generous vertical whitespace around a large centred logo, in the style of a newspaper masthead; its utility strip (contact/locale) is off by default, so most stores see just the logo row and nav ribbon. Dept Store is more compact and utility-first — its utility strip (policy links and locale label) is on by default, sitting above a standard-height Header Navbar and nav ribbon. Both read their utility-strip content from the same Utility Bar fields described under Header navigation below (utility policy links, locale label) — Masthead just doesn't show that strip until you turn its Show Policy Links / Show Locale/Currency Theme Settings toggles on.
Transparent Overlay — a header that floats over your hero, no bar visible until you scroll
This template renders with a fully transparent background directly over whatever is at the top of your homepage (typically a hero banner/image) — no bar, no border, no shadow. Once the customer scrolls down about 80 pixels, it automatically "solidifies": a solid background, border, and subtle shadow fade in, and the text/icon colour switches from light (for legibility over a photo) to your regular dark text colour. This solidify distance is fixed today (not yet a Theme Settings control). Because it reserves no space at the top of the page, it works best directly above a tall hero section — over a plain white background the effect is barely visible since there's nothing for it to "float over." This is a different mechanism from the classic Header editor's own Scroll effect toggle described below (Header appearance) — that one applies to whichever template you pick and lets you choose your own initial/scrolled colours; Transparent Overlay's overlay-and- solidify behaviour is built into the template itself and isn't combined with the classic Scroll effect toggle.
Side Rail — a vertical navigation column instead of a top bar (desktop only)
Side Rail replaces the usual horizontal bar with a fixed vertical column pinned to the left edge of the screen, spanning the full page height — your logo near the top, navigation links stacked underneath, and search/cart/account/login/signup toward the bottom. It doesn't reserve space at the top of the page the way every other template does. On phones and small tablets a full-height side column has nowhere to go, so Side Rail automatically collapses to the same compact top bar with a hamburger menu every other template uses on mobile — the rail itself is a desktop-only layout. The original 4 arrangements still apply on desktop: Standard stacks logo → navigation → actions top-to-bottom; Centered Split puts half the navigation above the logo and half below it (vertically centering the logo in the rail); Stacked groups the logo and action icons together near the top with navigation filling the rest; Logo Right (the vertical mirror of "logo right") pushes the logo down to the very bottom of the rail, with navigation and actions above it. The 3 newer arrangements (Nav Collapsed, Full Center, Nav Centered) are also selectable on Side Rail, but this doc doesn't yet have a verified description of how each rearranges the vertical column — if you pick one and the layout looks unexpected, switching back to Standard, Centered Split, Stacked or Logo Right is the safest known-good choice.
All 11 header templates require a paid plan
Every header structure is a flagship design, so on the Free plan every option in the structure switcher's menu shows a lock icon instead of the usual selectable state — clicking a locked option does nothing. Hover it to see "Upgrade to a paid plan to unlock flagship templates." The moment your store is on any paid plan — Starter, Growth, Pro, or Max — every structure unlocks; you don't need Pro or above specifically. Go to Billing → Plans & Billing to upgrade (see Plans & Billing). If a structure still shows locked right after you upgrade, reload the Admin Panel — the switcher reads your plan from a subscription check that runs when the page loads, so it can lag a freshly-completed upgrade by a page refresh.
A template can also show as unavailable
Separately from the plan lock above, a structure in the switcher's menu can be marked unavailable and become unselectable for a different reason (for example, it isn't ready yet) — hovering it explains why.
The 7 arrangements
Arrangement (rearranging the same header structure — logo/nav/actions positions) is a separate control from structure and look, and doesn't live in the template gallery drawer described above. Open the Theme Settings entry in the sidebar, switch to its Design tab, and scroll to (or jump-chip to) the Variant section — each arrangement carries an Arrangement identity chip.
| Arrangement | Layout | When to use it |
|---|---|---|
| Standard | The template's own native layout — whatever that design was originally built as | Keep this unless you specifically want a different arrangement; it's the best-tested option for that template |
| Centered Split | Logo dead-centre, navigation links split evenly left and right of it | A boutique/editorial look where the brand mark should visually anchor the bar |
| Stacked | Two rows — brand (and icons) centred on row one, navigation centred on row two below it | Stores with a longer navigation list that would crowd a single row, or that want a more spacious, brand-forward header |
| Logo Right | Mirrored layout — navigation and icons lead on the left, the logo sits on the right | Stores that want customers to see navigation first and treat the logo as a secondary sign-off |
| Nav Collapsed | Navigation links are fully hidden behind a drawer trigger even on desktop — only the logo and a trigger/actions cluster show on the bar itself | A very minimal bar where you want the nav out of sight until a customer opens it, without switching to the Minimal Hamburger Bar template |
| Full Center | Three centred rows — brand, then navigation, then actions, each on its own row | A tall, editorial-feeling header with heavy visual weight on every element |
| Nav Centered | Logo at the start, navigation centred as its own zone in the middle, actions at the end | Similar to Centered Split, but the navigation isn't split around the logo — it stays together as one centred group |
Nav Centered and Centered Split aren't the same thing
Both centre something, which is easy to mix up. Centered Split centres the logo and divides your nav links either side of it. Nav Centered keeps your logo at the start (left) and instead centres the whole navigation group as one unsplit block in the middle of the bar, with actions at the end. If your links keep swapping sides unexpectedly when you meant the logo to move, you likely have the two swapped.
Default: Centered Logo Split Nav, Centered Split
If you've never published your own header design, your store's default is the centered logo, split navigation layout (see Before you configure anything in Page-Layout Pickers) — the same look you'd get by explicitly picking the Centered Logo Split Nav template with the Standard variant.
Active, Selected, and Previously active — three different chip badges
Each Arrangement chip can carry one of three badges, and they mean different things. Active is the arrangement actually applied to your published/saved header right now. Selected is an arrangement you've clicked but not yet applied — it's staged, driving your live preview, but a page refresh or navigating away without applying reverts to Active. Previously active appears on the chip that used to be Active before you selected a different one in this session — it's a reminder of where you came from, not a control. Only one chip shows Active or Selected at a time; Previously active can appear alongside either.
Cart, wishlist, and account icons (Theme Settings)
Every one of the 11 templates ships three matching Theme Settings toggles under Features: Show Cart Icon, Show Wishlist Icon, and Show Account Menu — all on by default. When enabled, the cart and wishlist icons show a live count badge (hidden when the count is 0, capped at 99+), and clicking wishlist while signed out sends the customer to login instead of the wishlist page.
When you add these shortcuts to a Header row, Add block → Commerce presents Cart, Account, and Wishlist separately. See Add Cart, Account, or Wishlist to a header row for the complete setup flow and the behaviour of older combined blocks.
I added an Account block but LOG IN / SIGN UP still show
LOG IN and SIGN UP are separate from the account icon. On templates that carry them, each is its own capability with its own switch, so adding, removing, or hiding an Account block or the Show Account Menu toggle does not touch them. To remove them, select the Header Navbar row, open Content, open Built-in items, and switch off Login and Signup (the two switches are independent, so turn off each one you want gone). The Header's Behaviour lens no longer has a Components group. Publish for the change to reach customers. Both buttons only render for signed-out visitors, so check the storefront in a signed-out window. Centered Logo Split Nav has neither switch, and Dept Store ships with both off by default (its Account flyout is the sign-in entry point). A switch is dimmed with "Choose a header style that supports it to turn this on" when your current template cannot show it.
Two places can hide an icon — both must be on for it to show
These Theme Settings toggles work together with the classic Store Branding switches in the Header editor's Desktop mode below (Show Cart Icon / Show Wishlist Icon / Show User Menu): an icon renders only when both its Theme Settings toggle and its Store Branding switch are enabled. If you turned on Show Cart Icon here and the icon still doesn't appear on your storefront, check the matching Store Branding switch — either control alone can hide it, and remember the change reaches customers only after you Publish (Save Draft keeps it in the editor).
Color Schemes and Type Pairing (Theme Settings)
Two more controls sit in the Theme Settings entry of the sidebar — one for Header, one for Footer — that let you fine-tune colour and font pairing without leaving the template system for the Theme Hub.
Color Schemes. Theme Settings → Color Schemes. The Header page shows one row for the Header bar, plus a second Header panel (mega menu) row on templates whose mega-menu has its own colour axis. The Footer page shows two rows: Footer and Footer bands. Each row has two dropdowns:
| Dropdown | Options |
|---|---|
| Scheme | Default (no scheme), Surface, Inverse, Brand, and Transparent — on the Transparent Overlay header template, and on the Footer and Footer bands rows on every footer template |
| Emphasis | Standard, Subtle, Strong |
Default (no scheme) doesn't mean "no colour" — it means that surface keeps inheriting your store's regular active theme colours exactly as it did before this panel existed. Picking any other scheme overrides that surface's colours independently of your Theme Hub palette. This panel is hidden entirely while your store is still on the legacy (classic, pre-template-picker) header or footer — colour schemes only apply once you've published a premium template.
Footer bands — a shared default, not the same thing as the Style tab's Colour section
The Footer bands row carries a caption clarifying what it actually sets: "This sets the shared default background for every footer band. To style one band differently, select it in the Structure list and use the Style panel's Colour section instead." It's easy to read this row and the Footer editor's Style tab → Colour section (see Styling one band, group, or link: the Style tab below) as the same control reached twice — they aren't. Footer bands here is the one shared default every band in your footer falls back to before its own override; Style → This selection on one band sets that band's own colours specifically, and always wins over this shared default for that band.
Transparent — content sits directly on whatever ground you set below
On the Footer's Footer and Footer bands rows, Transparent is a translucent, colour-mix look rather than a solid fill — pick it when you've set a Ground image or Gradient-mesh ground (below) and want the photo or mesh to show through the surface clearly instead of sitting behind an opaque colour panel.
Ground image. The Header bar, Footer, and Footer bands rows each also have a Ground image (URL) field beneath their dropdowns — a background image for that surface, layered under the scheme colour above. Leave it blank to use the scheme colour only.
Gradient-mesh ground (Header bar, Footer, and Footer bands). Below the Ground image field on the Header bar, Footer, and Footer bands rows is a row of small colour-swatch buttons labelled Gradient-mesh ground (curated presets) — a curated set of abstract gradient-mesh backgrounds you pick with one click, rather than a freeform gradient editor. Clicking a swatch applies it and clicking the same swatch again clears it. A mesh preset and a Ground image URL are mutually exclusive on the same row: picking a mesh swatch clears whatever Ground image URL was set, and typing a Ground image URL clears whatever mesh swatch was selected — so a merchant is never shown both a photo and a mesh swatch as "selected" with only one actually visible on the storefront.
Why don't Scheme/Emphasis do anything on this row?
On the Header bar, Footer, and Footer bands rows, a Ground image or a Gradient-mesh ground preset paints over that row's Scheme/Emphasis colour entirely — the photo or mesh sits on top, so flipping Scheme or Emphasis while either is set produces no visible change on the storefront, even though the fields themselves still save. Once a Ground image URL or a mesh swatch is set on a row, a caption appears under its Scheme/Emphasis dropdowns confirming this ("Background is covered by the mesh/image ground — clear it below to see scheme colours."). Clear the Ground image field or click the selected mesh swatch again to reveal your scheme colours.
Footer bands mesh swatches are disabled on a footer with no bands
The Footer bands row's Gradient-mesh ground swatches only affect anything once your footer has at least one band (added from Compose this band with blocks below, or by picking a Look that seeds one). With zero bands there is no band surface left for those colours to paint, so the swatches are disabled — dimmed, not clickable, and skipped by keyboard tabbing — rather than silently accepting clicks that saved a value with no visible effect. Add a band first, then come back to set its gradient-mesh ground.
Ground composition — Boxed Card Newsletter footer template only
On the Boxed Card Newsletter footer template specifically, a Ground composition dropdown offers two options: Inset card (default) — the ground (colour, image, or mesh) fills the whole footer, and your content floats in an opaque card on top of it — and Transparent — your content sits directly on the ground with no card behind it, letting a photo or mesh ground show through uninterrupted. Every other footer template has no card to toggle, so this control doesn't appear for them. It's a per-band control, not a page-wide one: select the Legal Strip or Info band in the sidebar tree (Config mode — see Styling one band, group, or link: the Style tab below for the Config/Style toggle) and it appears near the bottom of that band's settings panel, not in the Layout Axes list.
Footer bands styling only shows once your footer uses bands
The Footer bands row's Scheme, Emphasis, Ground image, and Gradient-mesh ground only take visible effect once your footer has at least one band (Online Store → Theme → Page Layouts → Footer, sidebar tree — see Managing footer bands further down this page). On a store still using its template's default (bandless) footer layout, this row still saves whatever you set, but there's no band surface yet for it to paint — add a band first if you don't see it take effect.
Known issue — Aurora theme pack can hide a footer ground image
On stores using the Aurora theme pack, the footer's ground image can be visually stripped by a CSS rule in that theme pack while the Transparent scheme's text colour still switches as if the image were showing — a washed-out, colourless footer. This is a known defect, not yet fixed; if your footer ground image isn't showing and you're on the Aurora theme pack, that's the likely cause.
Footer Type — six typography axes on every footer template (Theme Settings → Layout → Layout Axes)
Every footer template's Layout Axes list carries the same six typography controls, all optional and all blank by default (blank = keep this design's own typography, byte-identical to before these controls existed): Footer Text Scale (a percentage — blank keeps this design's own sizes), Column Heading Weight (a font-weight select, blank keeps this design's own weight), Column Heading Capitalisation (Uppercase / Lowercase / Capitalize / none), Column Heading Letter Spacing (a percentage of one em — 12 means 0.12em), Footer Link Weight (a font-weight select for link/body text), and Footer Typeface (a Type Pairing id, blank keeps this page's own typeface — separate from the page-wide Type Pairing control above; setting this swaps fonts only inside the footer). The Reset axes button above the Layout Axes list clears all of them (and every other layout axis for the current template) back to blank in one click.
Group Numbering and Link Column Background Panel — also in Layout Axes
Two more controls live in the same Layout Axes list, on every footer template: Group Numbering
(None / Numeric / Padded / Circled, default None) numbers each footer link column, and Link Column
Background Panel (off by default) draws a filled card behind each footer link column — pair it
with the Link Column Panel Border checkbox to add a hairline border around each panel. Both are
part of the arrangement path's column rendering (LinkGroups), not the 7 templates' own
monolithic legacy layouts, so switching your footer's Variant away from Standard (see
Footer arrangements below) is what makes the columns these
controls style actually render as separate columns.
Wordmark Treatment — five options, including two architectural-scale tiers (Layout Axes)
Also in the Layout Axes list on every footer template: Wordmark Treatment, a select with five options — Display (default; today's plain rendering, untouched), Ghost (the wordmark scales up and fades to a low-opacity backdrop, reading as a decorative watermark behind the rest of the brand block rather than the primary heading), Clipped (a gradient text fill running from your accent colour into your ink colour — a "gradient wordmark" look), Giant (the wordmark grows to a large, viewport-relative display size at full opacity and the template's own colour — it becomes the brand block's primary heading voice, the opposite intent of Ghost's faded watermark), and Bleed (the same Giant scale, but the wordmark also becomes a full-width block that clips itself at its own edge rather than wrapping or overflowing — the "clipped at the band edge" placement). Because five options is more than the four-option cutoff this editor uses for a toggle-button row, Wordmark Treatment renders as a dropdown, not a row of buttons, unlike some of the other Layout Axes controls on this list. Giant and Bleed both make the wordmark reserve its own full-width row rather than sharing a row with a sibling element (a logo, on most templates) and consume the design's display typeface rather than its body typeface, so switching into either can visibly reflow the rest of the band — check the live preview after picking one.
Grid Lines and Motion — two more decorative axes on every footer template (Layout Axes)
Two further Layout Axes controls, both off by default and both purely decorative (they add no new content, only restyle what's already there):
- Grid Lines — None (default), Columns (three evenly-spaced vertical hairlines across the full footer, independent of your actual link-column boundaries — a decorative architectural overlay rather than a per-column rule), or Full (the same three hairlines plus a top-and-bottom hairline framing the whole footer). The hairline colour follows your footer's own ink/scheme colour, not a separate colour field.
- Motion — None (default) or Subtle, which adds hover choreography only — a colour/underline transition on link hover and a small lift on social icon hover. This is a different control from the band-level scroll-reveal ("fade up as the customer scrolls to it") that already existed before this wave; Motion doesn't touch that. Motion respects the customer's OS-level reduced-motion setting — a customer with "Reduce motion" turned on sees no hover transition at all, content and links unaffected.
Show Brand Name and Footer Link Display — two more Layout Axes on every footer template
- Show Brand Name — on (default) or off. Your footer always shows both your brand logo image and
your store name as text next to it; turning this off hides the text name and keeps the logo image
(the logo's
alttext stays set either way, for accessibility). On by default, so every existing store renders unchanged until a merchant explicitly turns it off. - Footer Link Display — Expanded (default), Dropdown, or Collapsed. Expanded is
today's look: every link column's heading and its links are always visible, with no click behaviour
on the heading. Dropdown makes each heading a disclosure trigger a customer can collapse, but every
column starts open. Collapsed starts every column closed, with a
+/−next to each heading that expands it on click — useful for mobile-heavy stores with long link columns. Any number of columns can be open at once in either mode; opening one never closes another.
Why didn't my footer columns change when I set Footer Link Display?
Expanded is the byte-identical default — if you want to see a difference, pick Dropdown or Collapsed. Also check you're looking at a footer template that renders link columns at all (Minimal Link, Split Two-Tone Panel, Divided Column Sidebar, Inline Column Newsletter, Boxed Card Newsletter); a footer with no Link Columns band configured has nothing for this control to affect.
Header Colors. Below Color Schemes on the Header's Theme Settings → Page Style group, a Header Colors section lists individual named colour swatches for the header specifically — in merchant language, not raw token names — for example nav text, a secondary/muted nav text (on templates that use one), one or more accent swatches, an Icon Color swatch, and background/surface swatches. Which exact swatches appear depends on your active template; each one shown is verified to actually be read by that template, so you won't see a swatch that quietly does nothing. A handful of templates also add status-dot swatches (small colour indicators some layouts render). This is different from the Advanced group's Color Overrides list further down the sidebar — that one holds store-wide tokens most of which the header doesn't consume at all; Header Colors is the scoped, verified-useful set for this surface.
Icon Color — the cart, wishlist, account, and search icons, independent of your nav text colour
Icon Color, in the Header Colors list above, recolours the header's commerce icons — cart, wishlist, account — and the search icon (both its default and active states) without touching your nav link text colour. It's a separate colour axis from Nav Link Color: before this control existed, those icons always followed your nav text colour, so a merchant who wanted, say, a dark-on-light nav with a brand-accent icon set had no way to split the two. Leave it blank and every icon keeps following your existing nav ink colour exactly as before — this swatch is unset by default on every store, so nothing changes until you pick a colour here.
Type Pairing. Theme Settings → Typography → Type Pairing. A curated catalog of paired display/body fonts — 62 pairings across four style tiers (editorial, geometric, display, and monospace), for example "Playfair Display + Inter", "Space Grotesk + Space Mono", or a single-family option like "Barlow" — plus a Template default option that leaves the template's own built-in fonts alone. Picking a pairing overrides your store's Theme Hub font choice for that header or footer only.
A separate typeface just for your navigation links
Theme Settings → Layout has its own "Menu Link" group of axes — Size, Weight, Capitalisation, Letter Spacing, and Menu Link Typeface — separate from the Type Pairing control above. Leave Menu Link Typeface blank and your nav links use the page's own typeface like everything else; pick an entry here (from the same 62-pairing catalog) and only the navigation links switch to it — your logo/wordmark and every other header element stay on the main Type Pairing. Use this when you want your nav to read in a distinctly different voice from your brand mark, e.g. a monospace nav under a serif display logotype. A link's own per-item font override (if you've set one) still wins over this. This axis reaches nav links wherever they render — including the links inside a mega panel and inside a disclosure panel — not just the top-level bar, so a Menu Link Typeface you've set carries through when a customer opens either kind of panel.
Decorative Treatment — an optional ornament on the header bar
Theme Settings → Layout has a Decorative Treatment select, off by default. Turning it on adds a subtle art-direction touch to the header bar: a floating-island inset, an editorial frame, a grid-lines pattern, a neon glow, one of three rule/underline styles (hairline, double, or thick), a heavier frame weight, a grain/noise texture, or a top-to-transparent gradient scrim (useful for keeping light header text legible over a photographic hero on templates without their own solidify-on-scroll behaviour). Leaving it unset renders exactly as before — this is purely additive polish, not a required step.
Layout Axes — more per-template controls live further down the same Layout group
Below Spacing Rhythm, Corner Radius, and Decorative Treatment, the Layout group shows a Layout Axes list of extra controls specific to your currently-active template — this guide doesn't enumerate all of them for all 11 templates, since each template contributes its own set. One worth knowing about: Underline Menu Links on Hover, a plain on/off switch (off by default) that adds an underline beneath a nav link while the customer's pointer is over it — available on the templates whose contract defines it. If a control you're looking for isn't in this guide, check this Layout Axes list on your own active template — it changes what's shown as you switch template.
Sticky Behavior (Theme Settings)
The Theme Settings entry also has its own Sticky Behavior control, separate from the Mobile mode's simple sticky toggle described later in this guide:
| Option | What it does |
|---|---|
| None | The header scrolls away with the page like ordinary content |
| Always (default) | The header stays pinned to the top of the viewport at all times |
| Smart Reveal | The header hides as the customer scrolls down and reappears as soon as they scroll back up |
When Smart Reveal is selected, an Initial Visibility option (Visible by default, or Hidden) controls whether the header is already shown or already hidden the moment the page loads, before the customer has scrolled at all.
This control is available on every header template. The footer has a more limited version of the same control, named Sticky Behavior, with three choices: None, Always and Reveal at end. A footer can't "reveal" on scroll-up the way a header can, since it sits at the bottom of the page; Reveal at end is its own variant (it makes the footer fixed, see the footer note further down). This is separate from the footer's Back to top button (None / Back to top / Scroll up), which controls the round arrow button; see The Footer Editor.
Shrink Header on Scroll — a Layout Axes toggle, separate from Sticky Behavior above
Theme Settings → Layout → Layout Axes (the same per-template axis list the callout above describes) carries a Shrink Header on Scroll switch on every one of the 11 header templates, off by default. Turn it on and the header bar's own height eases down as the customer scrolls past the threshold, with the logo and nav clamped to that shrinking bar rather than scaling or blurring the way an earlier version of this effect did. It composes with whatever height you've set on the header (a custom bar height shrinks from that height, not a hardcoded default). Side Rail shows the toggle too, but the template has no bar-height axis to shrink, so turning it on there has no visible effect; Masthead shrinks its ribbon row specifically rather than its identity row. There's no separate control for how much it shrinks by — the underlying shrink-scale value exists in the data model but isn't exposed as its own Layout Axes field on any template, so every store that turns the switch on gets the same built-in shrink amount.
Search Style — three shapes for the search field (Layout Axes, 8 of 11 templates)
Theme Settings → Layout → Layout Axes carries a Search Style select on 8 of the 11 header templates — Two Tier Utility Bar, Transparent Overlay, Dept Store, Side Rail, Floating Pill Navbar, Retro Arcade Bar, Masthead, and Tech SaaS Bar — with three options:
| Option | What the customer sees |
|---|---|
| Icon Overlay (default on 7 of the 8) | A plain search icon in the bar. Clicking it swaps the icon in place for an inline search form, right there in the bar |
| Inline Bar (Dept Store's default) | An always-visible search input sitting directly in the bar — no click needed to reveal it |
| Takeover | Clicking the search icon opens a full-screen overlay with a large, auto-focused input; a close (✕) button in the corner dismisses it |
Centered Logo Split Nav, Minimal Hamburger Bar, and Serif Luxury Bar don't show this control at all — those three templates ship with no search field, by design (Minimal Hamburger Bar stays deliberately bare; Centered Logo Split Nav and Serif Luxury Bar's curation briefs specifically omit login/search/signup to keep the bar uncluttered). If you've switched to one of those three and expected to see Search Style, that's why — switching to any of the other 8 templates brings the control back.
Search Style has no effect if search is off
Search Style only changes the shape search takes — it doesn't turn search on. If your header shows no search field at all (and you're on one of the 8 templates above), check the Features group's search toggle in Theme Settings first; Search Style is inert while that toggle is off.
Spacing Rhythm also scales the header bar height — only when Header Height is left blank
Theme Settings → Layout has its own Spacing Rhythm select — Compact, Standard, or Generous, same naming as the page-wide "Set a Spacing Rhythm" control described under Theme Customization for page sections, but this one is scoped to the header itself. It scales your header's bar height — Compact = 0.5×, Standard = 1× (no change), Generous = 1.5× the template's own reference height.
An explicit Header Height wins. If you've set the Header Height number under Layout Axes to a specific value, that value is what renders, full stop — Spacing Rhythm's scaling branch only runs when Header Height is left blank. A merchant who sets a Header Height and then changes Spacing Rhythm will see no change in the bar at all; that's expected, not a bug. To let Spacing Rhythm control the bar height again, clear Header Height back to blank (its reset icon, where shown, or delete the value).
Header editor: Desktop, Mobile, and Shared modes
The Header editor's Desktop / Mobile / Shared control at the top is not just a preview-viewport switch — it swaps the entire settings form underneath it. Each mode edits a different set of settings and drives a matching live preview on the right:
| Mode | What it edits |
|---|---|
| Desktop | Your navigation links, mega-menus, and header appearance (sticky, colours, scroll effect, icon toggles) — the desktop navbar |
| Mobile | The mobile-only navigation style, bottom-nav items, slide-out menu content, and mobile header bar — see below |
| Shared | Settings common to both Desktop and Mobile |
Tablet is a third device, set in Navbar device
Block placement for the Header Navbar is chosen with the Navbar device control (Desktop, Tablet, Mobile), described in Set the header per device. The Desktop and Mobile rows above keep their meaning; Tablet (768 to 1023px) has no row of its own because it follows Desktop or Mobile until you customise it there. Use the table for which settings live where, and Navbar device for which device's layout you are editing.
Where the mobile header settings live
The mobile navigation and header settings used to live on the Mobile Customization page. They've moved into this Header editor's Mobile mode — see Mobile Customization for the note left in their old location.
Spotlight the Header area you are editing
Use Spotlight when a full Header preview makes it difficult to see which row or child block your settings belong to.
Select a Header subject
Go to Online Store → Theme → Page Layouts → Header and select the whole Header, a row such as Header Navbar, or a child such as Logo & Brand Name, Navigation, Search, or Call-to-action in the structure tree. You can also click the part directly on the canvas: clicking the logo selects Logo & Brand Name, clicking the call-to-action button (including one inside the More menu) selects Call-to-action, and clicking the built-in Log In or Sign Up buttons selects the whole Header, where their settings live. Cart, Account, Wishlist, and Language / currency icons select their own rows when your template shows them.
Turn on Spotlight
Open the coloured status-dot menu in the canvas toolbar and select Spotlight. The selected area stays clear while the rest of the preview is dimmed and blocked, with a label identifying the area you are editing.
Move or clear the focus
Select another Header row or child to move the cutout. To work outside it, select the page-level Header, press Esc, or turn Spotlight off from the same status-dot menu. Clicking a dimmed area does not select anything there; it shows a short hint for about three seconds — "Editing (the area's name) — select the page to edit outside this area".
Esc clears the current selection and returns you to the page-level view, which removes the cutout. It does nothing while your cursor is in a text field, a dropdown, or an open dialog, so typing never drops your selection; click outside the field first if Esc seems to be ignored.
Spotlight starts on for Header and Footer and off on other pages. Once you switch it, the editor remembers your choice for this store in this browser (it is not saved to your storefront or shared with teammates). The same toggle works on page sections, where it dims everything except the selected section or block.
Spotlight is an editor-only viewing aid: it does not save a style or alter the published header. On a converted older header, it follows the visible child blocks that make up the selected row, so it still produces a usable cutout without silently writing a new row structure into your draft.
Spotlight has no visible cutout
First select a visible Header row or child and wait for the live preview to finish loading. A row hidden on the current device has no visible geometry to outline; show it for that device or switch the preview viewport. Turning Spotlight off always restores normal canvas interaction.
Start, Center and End containers
The Header Navbar row always has exactly three containers, Start, Center and End. Header Navbar → Content lists them all, and each container lists everything the header places there: the template's own built-in items (Logo, Navigation, Search, and the Cart & account icons row) together with any blocks you added. The structure sidebar nests the same items under the same three containers, even when a container is empty. Adding, moving, removing or reordering an item never creates a fourth container or an extra header row.
All placement is managed in this one place. The Design tab no longer has a Start/Center/End zone-order editor, and the Header's Behaviour lens no longer has a Components group.
Open the containers
Go to Online Store → Theme → Page Layouts → Header, select Header Navbar in the structure sidebar, and open the Content tab. Each container (Start, Center, End) lists its items. An empty container shows "Nothing here yet."
Edit an item
Select Edit on a row. Logo, Navigation and Search open their own settings panel (the same panel as selecting that part in the sidebar); other rows open that block's own settings. The Cart & account icons row has no settings panel of its own: Edit on it opens the Built-in items group below the containers and scrolls the inspector to it. That group holds the switches for the Cart, Account, Wishlist and Language / currency items (and Login and Signup where your template carries them).
Add a block
Select Add block under a container to add a new block to that container.
Move an item to another container
Every row, including Logo, has a Move to container dropdown listing Start, Center and End. Pick another container and the item moves there, and the sidebar nests it under the new container. Moving a built-in item (Logo, Navigation, Search, icons) changes the Desktop header layout.
Remove or restore an item
Select Delete on a row to remove it. Logo shows a lock and cannot be removed, only moved. A removed built-in item is listed under Removed items below the three containers; select Restore next to it to bring it back at its default container for that device.
Choose how a container arranges its items
Under each container, Arrange items is Side by side or Stacked. Spacing lives in Design: open Header Navbar → Design → Navbar spacing & actions, where Item spacing inside containers has an Inside Start, Inside Center and Inside End block. Each has Align items (Start, Center or End) and Gap; these control spacing only, not which container an item sits in.
Switch built-in icons and buttons on or off
Below the containers, open Built-in items (the switches such as Login, Signup, Cart, Wishlist and Account that used to sit in Behaviour → Components). A switch is dimmed with "Choose a header style that supports it to turn this on" when your template cannot show it. Publish for the change to reach customers.
What customers see: items in Start sit at the left of the header, Center items are centred, and End items sit flush at the right edge. Items stay inside their container on the storefront, with no stray vertical scrollbar.
Edge cases:
- Removed items lists only what Restore can bring back. An icon (Cart, Account, Wishlist, and so on) appears under Removed items only when it is switched on under Built-in items and has been hidden. An icon whose Built-in items switch is off, or that your template cannot show, is never listed there. Switch it on under Built-in items first.
- Logo display. Select Logo & Brand Name under Header Navbar (or select Edit on the Logo row) and open Content. Logo display offers Current design, Image, Brand name and Image and brand name. Image shows only the logo image, with no visible brand name or tagline (the name stays as the image's accessible name). Save, then refresh the preview to see the change. Brand name shows text only. Image and brand name shows both. If the text you still see sits inside the logo picture itself, it is part of the uploaded image file.
Why did my header button move into More?
When the header runs out of width (a narrow window, a long menu, many items), lower-priority items give way before navigation does. A text note (such as a free-shipping message) goes first, then the divider next to it, and the call-to-action button last. The note and the button move into the More menu and still work; nothing is deleted from your header. The divider is only a decorative line, so it is dropped rather than listed in More. To keep the button on the bar, give the header more room: remove or shorten other items, or move an item to another container.
Why did my header button disappear?
The header call-to-action button has no default text, and it shows only when it has a label. A header you have not configured shows no button, and "Start Free Trial" is never added for you. To get a button, select Call-to-action in the Header structure tree (Online Store → Theme → Page Layouts → Header), type your own text in Label and a destination in Link, make sure Show CTA is on for the device you are checking (desktop and mobile have separate switches), then save and publish. If the button vanished from a header that used to show one, check these in order: Label is not empty; Show CTA is on for that device; and the button has not simply moved into the More menu because the bar ran out of room (see the previous tip). New headers also start with the CTA button, the text note and the divider switched off, so they appear only after you turn them on and fill them in. Hard-refresh the storefront afterwards, since a stale published page can hide a change that already saved.
I chose Image but my brand name still shows
Image only hides the text when a logo image is actually showing. If no logo image is uploaded, or the image fails to load, the header falls back to the brand name so the logo area is never blank. Upload a logo under your store branding, then save and refresh the preview. If the visible text is part of the uploaded picture, it is baked into the image file. Also check that you changed Logo display on Logo & Brand Name, not on a different block.
I removed Cart or Account but they are back, or they are not in Removed items
Items that are still part of the header come back when their Built-in items switch is on and nothing hides them. Open Header Navbar → Content → Built-in items and check the Cart, Wishlist and Account switches: switch an icon off there to keep it gone, or on to bring it back. If an icon you removed is missing from Removed items, its Built-in items switch is off (or your template cannot show it), because that list only holds icons that are switched on. Delete removes one item, so check the other containers too: a copy added as a block in another container still shows.
Why don't my Cart / Login icons show?
Check, in order: (1) Header Navbar → Content → Built-in items has Cart, Login, Signup, Wishlist or Account switched on (Login and Signup also need a signed-out visitor and a template that carries them); (2) the item is not under Removed items (select Restore); (3) you are looking at the right device, Desktop or Mobile; (4) you published the Header.
Why is my End-container block not on the right?
Confirm the block is actually in End (open Header Navbar → Content and check which container lists it, or use its Move to container dropdown). Items in End are aligned to the right edge. If the container's Arrange items is Stacked, items are stacked vertically instead of side by side. Publish and reload the storefront to see the change.
Built-in items move when you add them
On the Header Navbar row, the header already shows a built-in Search, Cart, Account, and Wishlist. When you add the matching block from Content → (Start, Center, or End) → Add block, the block becomes the one copy: the built-in item is hidden and your block shows in the zone you chose. You never end up with two carts or two search fields.
Add the block
Select Header Navbar, open Content, and select Add block under the Start, Center, or End container. Pick Search, or Cart, Account, or Wishlist from Commerce. The row's hint reads: "Start, Center and End are fixed containers. Add, edit, remove or move items between them here. Restore removed items from the list above. Logo stays required but can move."
Check where the built-in went
The built-in item disappears from its old position and the new block appears in the zone you picked. Selecting the block opens that block's own settings.
Remove it to restore the built-in
Remove the block (its remove action in the zone list). When the last block of that kind is gone, the built-in item returns at its default position. An item that is no longer shown appears under Removed items in the same Content panel; select Restore next to it (see Removed items and Restore).
Other points:
- Logo is locked: its row in the container list shows a lock and it cannot be removed, but it can be moved to another container. In the structure sidebar the Logo & Brand Name part likewise has no hide or remove button.
- Moves are per device. The built-in item is hidden only on a device where your block is actually displayed. If your block is not displayed on mobile, the built-in Cart, Account, Wishlist, or Search stays on the mobile header; the same holds for Desktop. Removing the last block of that kind restores the built-in on each device that had been handed over.
- Search, Cart, Account, and Wishlist are one-of-a-kind. Once one is placed in a zone, its entry in the Add block picker is greyed out and reads "Already placed — edit or move the existing item." Edit or move the placed block instead of adding a second.
- A Search that was moved or removed shows under Removed items. Open Header Navbar → Content; the Removed items list shows a Search that has been handed over to a block or that was hidden. Select Restore to bring it back. Placement lives only in Content, so there is no second list in Design to disagree with it.
- A draft saved before this change that hid Navigation or Search through the old part toggle opens with those items already listed under Removed items. Opening such a draft only changes the display; it is not rewritten until you make an edit.
- This move behaviour applies to the Header Navbar row only. On Announcement Bar, Utility Bar, and Secondary Navigation, blocks are added alongside the row's content, and the hint reads "Added blocks share this row with its main content. Remove a block to remove just that element. Use Design to switch to a blocks-only layout."
- Keep this row's built-in layout (under Design) is on by default. Its helper text reads "Your blocks share one row with its built-in content." Turn it off and it reads "Only your added blocks appear in this row; built-in content is hidden." Each container's layout choice, Arrange items (Side by side or Stacked), now sits under that container in Content.
- A Secondary Navigation row with nothing in it shows "No secondary links yet. Add links to show this row on your storefront." and an Add links button.
- Which blocks the Add block picker offers depends on the row: Announcement Bar offers Announcement and Free-shipping progress; Utility Bar offers contact, social links, store hours, utility links, language and currency, and pincode check; Header Navbar offers Search, the Cart / Account / Wishlist choices, a button, divider, spacer, text and paragraph; Secondary Navigation offers Category links.
Why is my built-in cart (or search, account, wishlist) gone?
You, or a teammate, added the matching block in a Start, Center, or End container of Header Navbar → Content, which hands the built-in over to it on that device. Look for your block in the container list. Remove the last block of that kind and the built-in returns. If it does not, check Removed items in the same Content panel and select Restore, then confirm Show Cart Icon, Show Wishlist Icon, and Show Account Menu are on (see Cart, wishlist, and account icons).
I added Cart (or Search) and customers see no cart (or search)
Check you edited the Desktop or Mobile view the customer is using, and that the block is not hidden for that device. Open Header Navbar → Content and look under Removed items: an item you removed earlier stays there until you select Restore. Then save and publish the Header; the draft does not reach customers until it is published.
Set the header per device: Desktop, Tablet, Mobile
The Header Navbar's Content panel and its Design slot panel carry a Navbar device control with three buttons: Desktop, Tablet, and Mobile. Block placement, Start/Center/End membership, and Login/Sign up visibility are saved per device, so a layout you build for one device does not move anything on the others. Tablet is the band between 768px and 1023px wide.
Pick a device
Select Header Navbar, then choose Desktop, Tablet, or Mobile in Navbar device. The canvas switches to that frame (Tablet previews at 768px) and the Start, Center, and End lists show the blocks for that device.
Understand what Tablet inherits
Until you change something on Tablet, the status line reads Tablet follows Desktop (or Tablet follows Mobile, depending on the store's mobile breakpoint). The first edit you make on Tablet gives it its own layout and the line reads Tablet has its own layout.
Go back to the inherited layout
On Tablet, select Reset tablet to Desktop (or Mobile) to discard the tablet-only layout and follow the base again. On Mobile, once you have customised it, Reset mobile to template default returns the mobile layout to the header template's own default. Reset does not touch a block's own Hide on mobile switch; change that on the block.
Stores without a tablet layout are unchanged
Nothing about the header changes until you edit it on Tablet. Stores that never customise Tablet render exactly as before.
Add a block to a specific zone
Each of the Start, Center, and End containers has its own Add button. It opens the block picker already targeted at that zone, so the block you choose lands there for the device you are editing. The picker lists the regular blocks plus four built-in header actions:
| Entry | What it adds |
|---|---|
| Navigation | The template's main navigation links |
| Mobile menu | The menu button that opens the mobile drawer |
| Login | A Login button |
| Signup | A Sign up button |
A built-in entry that cannot apply on the device you are editing is shown disabled with the reason beside it, for example "On mobile, navigation lives in the Mobile menu" (Navigation is unavailable on Mobile) and "On desktop, links show in the navigation bar instead of a Mobile menu" (Mobile menu is unavailable on Desktop). Login and Signup are available on all three devices.
In the Built-in items group, a row is locked, with the reason "Already added as a block in a container on this device. Remove that block to use the built-in item.", when an authored block already shows that action on the device you are editing. Remove the block to unlock it. The CTA button is never listed as a built-in item: add it with Add block in a container (it sits in the End container by default).
Login and Sign up as movable blocks
By default the header draws its native Login and Sign up pills in the template's own position. Every header template that draws these pills lists them as Login and Sign up rows in the Header outline, including Two-tier utility bar, Department store, Masthead, Side rail, and Transparent overlay, and including stores whose saved header has empty rows. The one template with no native pills is Centered logo split nav, so it lists no rows. Opening the rows changes nothing until you hide or move one.
Hide a pill on one device
Choose the device in Navbar device, then hover the Login (or Sign up) row in the outline and select Hide. The pill disappears on that device only; Desktop, Tablet, and Mobile each keep their own setting. Select Show on the same row to bring it back.
To place a pill yourself instead:
Add or move the button
Use Add on a zone and pick Login or Signup, or move the native pill's row to another zone. This creates a Login or Sign up block in that zone and hides the native pill on that device only; the other devices keep their pills.
Edit the block
Select the block. Label (up to 40 characters; blank uses Login or Sign up) sets the text, and Appearance chooses Template, Primary, Secondary, or Link. Template uses the header template's own pill style. The block's device switches choose where it shows.
Restore the native pill
Remove the block. Once no block is placed for that action on that device, the native pill is available again.
An unmoved native pill has no label or style fields; selecting it shows the notice "Move this button into a zone to customise its label and look." Both buttons only show to signed-out visitors, and only when the store's login/signup is enabled. When both native pills are hidden on a device and no Login/Sign up block is placed, signed-out visitors get the single Account icon instead.
My Login button shows on desktop but not on mobile
Placement is per device. Switch Navbar device to Mobile and check that a Login block is in a zone there, or that the native pill was not hidden for Mobile.
Click header parts on the canvas, and review the live version
The canvas toolbar's Single and Compare buttons choose between one device preview and all three side by side. On the Header, a part you click in either view is selected, including parts that render only on mobile; a part that is not shown on any device cannot be clicked. Clicking the announcement bar, the utility bar or the main navbar background selects that row in the rail and opens its inspector, and clicking the logo selects Logo & Brand Name. Esc pressed while the preview has focus is passed to the editor and clears the selection, just as it does when the editor has focus. Selecting a part keeps the Spotlight cutout on the whole Header rather than shrinking it to that part, so the next part you click is still reachable. A dimmed area still shows the hint described above.
If the top bar shows Live — draft differs on the Header, select it to open History. There, Restore live version opens a Restore live version? confirmation and replaces your draft with what is published. If the live version cannot be fetched, History shows "The live version could not be loaded. Close and reopen History to try again." and the button stays disabled.
Header parts and row panels
Every header template — all 11 designs, including an older header that was converted rather than built from scratch — lists the same four core parts under Header Navbar in the structure sidebar: Logo & Brand Name, Navigation, Search, and Call-to-action (alongside Cart, Account, Wishlist and any other blocks you added). The editor's sidebar calls the main row Header Navbar, and this guide does too; older screenshots or notes may call it the "Main Bar". The parts are a way to reach each piece's settings; showing them does not add rows or blocks to your saved header, and just opening the editor changes nothing on your storefront.
Open a part
Go to Online Store → Theme → Page Layouts → Header, then click Logo & Brand Name, Navigation, Search, or Call-to-action under Header Navbar in the sidebar. The inspector on the right switches to that part's settings, and the canvas outlines it if Spotlight is on.
Open a row
Click Announcement Bar, Utility Bar, Header Navbar, or Secondary Navigation in the sidebar. The row opens with a Header › (row name) breadcrumb across the top of the inspector.
Go back
Click Header in the breadcrumb, click the back arrow (Back to Header), or press Esc to return to the Header's Theme Settings view. Esc goes back even while a field in the row panel has focus, so finish typing before you press it.
The sidebar lists Cart, Wishlist, Account, and Language / currency only when the header would really show them, using the same rules as your storefront: the Theme Settings toggle and Store Branding switch for that icon are on, the item is not listed under Removed items in Header Navbar → Content, and the Header Navbar row is displayed. Account can also be absent on designs that show their own Log In and Sign Up buttons while the customer is signed out. Language / currency needs a locale label or current language/currency set under Utility Bar. A block you added yourself appears as its own row regardless of this. If an item you expect is missing from the sidebar, it is missing from the storefront for the same reason; the four core parts above are always listed.
Utility Bar, Announcement, and Header Navbar rows use the inspector's Content, Design, and Behaviour tabs.
| Row | Content | Design | Behaviour |
|---|---|---|---|
| Utility Bar | Utility bar message and Message link, Contact phone, Contact email, Location address, Locale label, Current language, Current currency, and link lists for Policy links, Utility menu links, Account links, and Social links (each with Add link / Remove link) | Alignment: Theme default, Left, Center, or Right; colour rows for background, text, link hover, and border (see Per-section Design) | "This row has no behavior settings." |
| Announcement | Message, Link (optional); Messages (one per line) when the behavior is Rotating; Counts down to and Timer label when it is Countdown; Button label (optional), Button link, Button opens in | Alignment, Background image, Show separator line, and Border colour | Display behavior (Static, Marquee, Rotating, Countdown), Direction for Marquee (Right to left or Left to right), Let customers close the bar, Keep visible while scrolling |
| Header Navbar | Menu links editor (see below) plus the row's Start, Center and End containers and a Built-in items panel | Navbar spacing & actions (the Item spacing inside containers group with Inside Start, Inside Center and Inside End, each with Align items and Gap, plus the action settings; the Start, Center and End zone-order editor is gone from Design) and the navbar-only colour rows (see Per-section Design) | "This row has no behavior settings." |
Changes to the Utility Bar and Menu links fields save as you type. Announcement row fields work differently: they go into your draft and reach customers only when you publish the Header (see Announcement row: draft saving, button, and background image). Announcement rows on a grid-style announcement layout also show the announcement zones editor under Content.
Utility Bar: fields hidden for this layout
Not every header design can show every utility field. When your chosen structure does not support some of them, the Utility Bar panel shows "N fields are hidden for this layout." with a Switch layout button that opens the template gallery. If a phone, email, or locale field you expect is missing, that is the reason — pick a structure that supports it rather than looking for a setting to enable.
Announcement row: draft saving, button, and background image
Select Announcement Bar in the structure tree of Online Store → Theme → Page Layouts → Header. The panel has three tabs: Content, Design, and Behaviour.
Write the message (Content tab)
Fill in Message and, if the whole bar should be clickable, Link (optional) (for example
/collections/sale). In Behaviour → Display behavior, Rotating adds a Messages (one per
line) box and Countdown adds Counts down to and Timer label to the Content tab.
Add a button (Content tab)
Fill in Button label (optional) and Button link, then choose Button opens in: Same tab or New tab. The button shows only when both the label and the link are filled in. A label with no link, or a link with no label, shows no button.
Set the look (Design tab)
Alignment is Theme default, Left, Center, or Right. Background image opens
the media picker; use its reset action to remove the image. Show separator line is an on/off
switch. Border colour takes a colour code such as #D9DDE5.
Choose the behaviour (Behaviour tab)
Display behavior is Static, Marquee, Rotating, or Countdown. Direction appears for Marquee only (Right to left or Left to right). Let customers close the bar adds a close button. Keep visible while scrolling keeps the bar on screen as the page scrolls.
Save and publish
Select Save Draft, then Publish. Customers see none of the changes in steps 1 to 4 until the Header is published, except the two controls in the warning below.
These fields now live in your draft: Message, Link, Display behavior, Messages, Counts down to, Timer label, Button label, Button link, Button opens in, Alignment, Background image, Show separator line, Let customers close the bar, and Keep visible while scrolling. Earlier versions saved the announcement row to your live store the moment you typed. Now you can edit and check the preview without anything reaching the storefront, and the changes ride the same Save, Publish, and History flow as the rest of the Header draft.
Border colour and marquee direction still apply immediately
Two controls are not part of the draft: Border colour (Design tab) and Direction for Marquee (Behaviour tab). They save to your store as you change them, so they can reach customers before you publish the rest of the Header.
Why don't customers see my announcement change, or my button?
Confirm you selected Publish after Save Draft. For the button, check that Button label (optional) and Button link are both filled in. If the whole bar is missing, check the row's Show eye is on and that Message is not empty: an empty message hides the row.
After you apply a store template. Open Announcement Bar in the Header structure tree. If the template includes announcement text, Message (Content tab) already shows it; before this fix it appeared empty. Whatever you type in Message or the other announcement fields overrides the template's value, and your edit is kept. Saving any Header change also keeps the rest of the template's header settings, such as the logo size, header icons and announcement row, instead of dropping them.
Why don't I see the announcement bar on my storefront after applying a template?
Check that the draft is published (Save Draft, then Publish, and for a store template the Publish all review) and that Message is not empty. If the text is there but the bar still does not show, your header layout may be one that does not draw it. Try Layout → Layout Axes → Announcement & Utility Bars as Their Own Rows and set it to Stacked (see Announcement & Utility Bars as Their Own Rows). That control appears only on headers without a tier stack; on a header that uses its own tier stack, the text stays saved but is not shown until the row is shown in the structure tree.
Menu links. The Navigation part and the Header Navbar row share one Menu links editor, so a link you change in one place is the same link in the other. Each row has a Show toggle and a More actions menu with Edit, Duplicate, Move up, Move down, Make dropdown, Make mega menu, and Delete (Protected link entries cannot be deleted). Add link at the bottom opens the same label-and-destination form. The Navigation part also has Menu source (Store menu or Categories), Item style (Links, Pill, Underline), Active item style, Open menus on (Hover or Click), and When links do not fit — the same options described under Header navigation.
Edit mega menu. A link that already carries a mega panel shows an Edit mega menu action in two places: in its More actions menu (next to Make mega menu), and as an Edit (link name) mega menu button under the list in the Navigation part. Both open that link's mega panel settings directly. For a link with no mega panel yet, use Make mega menu first. The master switch under Theme Settings → Features → Mega Menu must be on, as described in The Mega Menu master switch.
A part or a tab is missing from the panel
Check that you selected the part under Header Navbar (not only the whole header) and that the preview has loaded. A Behaviour tab that says "This row has no behavior settings" is normal for the Utility Bar and Header Navbar; only the Announcement row has behaviour controls there.
Per-section Design and header-wide looks
Header Design is split by section, so a colour you set on one row does not repaint the others.
Open the header-wide Design overview
Select Header (the root), then the Design tab. A Header section design list shows one button per section: Announcement Bar design, Utility Bar design, Header Navbar design, and Secondary Navigation design, plus Navigation & mega-menu design. Each opens that section's own Design tab.
Set the header-wide behaviours below the list
The Header settings panel under the list holds only whole-header choices, in four groups:
| Group | Controls |
|---|---|
| Sticky and scroll | Pinned, Hide on scroll, show on scroll up, or Scrolls away; plus Transparent over the hero image, solid on scroll with a Become solid after pixel value |
| Spacing | Density: Compact, Regular, or Tall |
| Shape | Bottom border: Current design, On, or Off |
| Effects | Shadow: Current design, On, or Off |
Colour a single section
Open that section's Design tab (from the list, or by selecting the row in the structure tree) and use the colour rows in the table below. A colour row that has never been set says Follows theme; use Reset to theme on the row to clear your colour.
| Section | Design colour rows | Customer result |
|---|---|---|
| Header Navbar | Header bar colors (a colour-scheme choice) with Header bar emphasis, Header bar background image, Header background, Nav Link Color, Nav Link Color (Muted), Header Text Color, and Action/Icon Color | Affects the main navbar row only. Other rows keep their own colours. When you pick a Header bar colors scheme whose accent would make the header call-to-action text hard to read, the button text switches automatically to black or white for readability |
| Secondary Navigation | Secondary navigation background, Secondary navigation text color, Secondary navigation link hover color, Secondary navigation border color | Recolours the second link row below the navbar. These rows are not shown for the Side Rail and Transparent Overlay header templates, which have no secondary row |
| Utility Bar | Utility background, Utility text color, Utility link hover color, Utility border color | Recolours the utility strip, including the hover colour of its links and of the language and currency buttons. These rows appear only when the chosen header design has a Utility Bar |
Colour the Secondary Navigation or Utility Bar
Open the section's Design tab
Go to Online Store → Theme → Page Layouts → Header. In the structure tree, select Secondary Navigation (or Utility Bar), then open the Design tab and its Colors group. You can also reach it from Header → Design → Header section design by choosing Secondary Navigation design or Utility Bar design.
Pick a colour on the row you want
Each row shows a colour swatch. Choose a colour to set it for that row only. Secondary Navigation has Secondary navigation background, Secondary navigation text color, Secondary navigation link hover color, and Secondary navigation border color. Utility Bar has Utility background, Utility text color, Utility link hover color, and Utility border color. The text colour covers the row's links; the link hover colour is what a link turns when a customer points at it. On the Utility Bar it also applies to the language and currency buttons.
Leave a row alone, or reset it
A row you have not set says Follows theme and the row keeps its template's own colour. The Secondary Navigation rows show Template default as their starting point, because that row has its own template colours rather than borrowing the navbar's. To go back, use Reset to theme on that row; it clears only that one colour, not the other three.
Save and check the storefront
Save the draft, publish the Header, then hover a link in that row on your live store to confirm the hover colour.
Setting the Secondary Navigation colours never changes the Utility Bar colours, and the other way round. Neither changes the Header Navbar row.
Colour changes you may notice on existing stores
The navbar background, background image, mesh, link colour, and muted link colour used to bleed into the Announcement, Utility, and Secondary rows. They now apply to the Header Navbar row only, for every store. A store that previously set a navbar colour will see the other rows return to their own colours until you set them on those sections' Design tabs.
My Secondary Navigation colours do nothing
Side Rail and Transparent Overlay headers have no secondary row, so the Secondary Navigation colour rows are not shown at all on those two templates. Switch to another header structure to get them. On any other template, also confirm the row is shown and has links: an empty Secondary Navigation does not render. Then save and publish the Header. For Utility link hover color, the Utility Bar must be shown and the chosen header design must have one; the row is not listed otherwise. Hover colours are only visible with a pointer, so check on desktop.
Header navigation (Desktop mode)
Open Header from the Page Layouts journey rail, then make sure the mode switcher at the top is set to Desktop.
Navigation links
Select Online Store → Theme → Page Layouts → Header → Header Navbar → Navigation. The compact Menu links list contains every built-in and custom destination in its storefront order. Select a row to edit it; use its drag handle to reorder it, its switch to keep it saved but hidden, and More actions for the non-drag alternatives.
The destination text appears when a row is hovered or focused. A protected built-in link also shows a lock: its visibility switch and Delete action are disabled, so a required store route cannot be hidden or removed accidentally.
Choose what to add
Select Add link. The panel asks What would you like to add? with six buttons: Link, Dropdown, Mega menu, Drawer, Takeover, and Rail flyout. Link is a plain destination. The other five create a menu item and immediately open the matching panel's editor (a dropdown list, a mega menu, a full-height drawer, a full-screen takeover, or a rail flyout).
Finish a plain Link
Link opens a form with Label and Destination type. The type is one of:
| Destination type | What you choose | Customer result |
|---|---|---|
| Internal page | A page, picked with Choose a page | Opens that storefront page |
| Category | One product category | Opens that category |
| Product | Search the catalogue, then choose from the list below the search | Opens that product |
| External URL | A complete address starting with https:// or http:// | Opens the outside address |
For Product, the list shows "No matching items." when the search finds nothing and "Could not load items. Try another search." if the catalogue request fails. Save stays disabled until the label is filled and the destination is valid (an external URL must start with http or https). Use the Menu links back button to leave the form without saving.
Reorder or transform a saved row
Drag the handle, or focus it and press Space to grab the row, Arrow Up/Down to move it, and Escape to cancel. The row's More actions menu also provides Move to top, Move up, and Move down, plus Edit, Duplicate for custom links, Make dropdown, Make mega menu, and Delete where allowed.
Save and publish the Header
Check the selected link on the canvas, select the top-bar Save action, then publish the Header when customers should receive it. A hidden row remains in Menu links but does not appear in the published navigation.
Secondary navigation row
Use Secondary Navigation for a separate link row below the Header Navbar. It is authored independently from Header Navbar → Navigation → Menu links: showing this row does not copy or inherit the main menu.
Show the Secondary Navigation row
Go to Online Store → Theme → Page Layouts → Header. In the structure tree, select or hover Secondary Navigation and choose its eye action, Show. The row is available on the horizontal header families; its position is below the Header Navbar.
Open its independent link editor
Select Secondary Navigation. A new empty row says No secondary links yet. Add links to show this row on your storefront. Select Add links. A blank row does not fall back to the Header Navbar menu and does not create an empty customer-facing strip.
Choose the link source
Set Link source to Manual to use Add category link. For each entry, complete Label and Link; optionally turn on Highlight as sale, or delete the entry. Choose Top-level categories to populate the row from your catalogue instead; Sale category names accepts a comma-separated list of category names to highlight.
Choose overflow and save
Set When links overflow to Wrap or Scroll, review the separate row in the canvas, then select the top-bar Save action and publish the Header when customers should receive it.
Secondary Navigation is unavailable on two structural headers
Side Rail disables the row because it uses vertical navigation. Transparent Overlay disables it because that layout uses one over-hero navigation row. The structure tree states the matching reason; switch to a horizontal header family if you need a separate secondary row.
The Secondary Navigation row is shown but nothing appears
Select Add links, then either save at least one Manual entry with both Label and Link, or choose Top-level categories. The row deliberately renders nothing while its independent source is empty; changing the Header Navbar's Menu links cannot populate it.
A chevron marks links that open a panel
Once a link has a mega panel or a disclosure panel configured, the storefront shows a small chevron next to its label so customers can see there's something to open — plain links (nothing configured under Opens) render without one. This is automatic and not a separate setting. It shows on all 11 header templates except Minimal Hamburger Bar, which already has its own +/- disclosure indicator for the same links.
Dropdown (simple list) and Opens → Dropdown panel are different
Choosing Dropdown (simple list) as the destination creates a simple list of child links. The separate Opens control is available on a link with a stable destination and attaches a richer disclosure surface: Dropdown panel, Mega panel, Side drawer, Full-screen takeover, or Side rail. Use Mega panel when you need columns, links, and image tiles.
Opens stays disabled until the link has a stable destination
The helper explains what is missing: enter an internal path or external URL, select one category, or select at least two categories for a Collection. Dropdown (simple list) does not show Opens because its child list is already the opening behavior. Choosing a panel while adding a link saves the link first and then opens that panel's editor.
Mega panels work on category links too
A Category Filter or Collection link can carry a Dropdown panel, Mega panel, Side drawer, Full-screen takeover, or Side rail exactly like an internal or external link. Choose it from Opens after making the category selection. The panel remains attached if you later edit which category or categories the link uses.
Dropdown style — a nested, multi-column dropdown (Tech/SaaS Bar template)
Screen: Online Store → Theme → Page Layouts → Header → Header Navbar → Navigation → Menu links. Select a link row or Add Link. Below the destination field, a Dropdown style (optional) select offers Simple (flat dropdown / mega panel) (the default — today's flat list or mega panel, unchanged) and Multi-column (categories reveal nested links on hover). It appears for built-in/internal, External URL, Category Filter, and Collection links — not for a Dropdown (simple list) link, which has its own separate nesting model (see the "Dropdown (simple list) and Opens" note above). Picking Multi-column shows a hint pointing you to that link's Mega panel — each category entry there can now carry its own one-level-deep list of nested links, edited inline (drag to reorder, add/remove, each with a Label and URL) right under that category's row.
Selecting Multi-column only takes effect once that link has categories authored through its separate Make mega menu action (opened from the link row's More actions menu, not from inside the Edit Link dialog). Until at least one category with links is added there, the link keeps rendering its previous dropdown (its disclosure panel, if one is authored, or its flat sublinks) and the Edit Link dialog shows an inline warning reminding you to use Make mega menu. If your template doesn't have Mega Menu enabled, enable it first (Header settings → Mega Menu capability) — the warning text changes to mention this when it's off.
On the storefront, a customer hovers or Tab-focuses the nav link to reveal the panel, then Arrow Right on a category reveals its nested links, Arrow Left returns to the category list, and Escape closes the panel and returns focus to the nav link. On mobile it opens as a nested accordion inside the slide-out menu — opening one category's nested links closes any other open category.
This control is only available on the Tech/SaaS Bar header template today — picking Multi- column on a link and switching to any of the other 10 header templates has no visible effect there (the field is simply not read by those templates yet). Leaving Dropdown style on Simple (the default) never writes the field at all, so an untouched link's dropdown renders exactly as it always has. Troubleshooting — my multi-column dropdown isn't multi-column: confirm you're on the Tech/SaaS Bar template, and that Dropdown style is actually set to Multi-column on that link (not just that its Mega Panel has categories) — a Mega Panel's column/entry structure with Dropdown style left on Simple still renders as the regular flat mega panel. My nested links aren't showing: nesting only goes one level deep below a category — a nested link that itself has children won't show its own dropdown, and the nested-links editor itself only appears once the OWNING link's Dropdown style is set to Multi-column, not per category.
Submenu Arrow — a Layout Axes control for the dropdown chevron
Every header template shows a small chevron next to a nav link that opens a mega panel, disclosure panel, side drawer, or takeover, to signal there's more underneath — except Minimal Hamburger Bar, which never renders an inline dropdown-style nav link at all (its only nav surface is the full-screen slide-out overlay), so there's no attach point for a chevron on that template. On the other 10 templates, this chevron is a merchant-facing setting: open Online Store → Theme → Page Layouts → Header (or Edit Header → HEADER for a premium template), select your header row in the structure tree, and scroll the settings panel to Layout Axes. Find Submenu Arrow (dropdown links with a panel/mega-panel/sublinks) in that list and set it to Chevron — it's a two-option control (None / Chevron), rendered as a small toggle since there are only two choices. Leave it at None (the default) and no arrow shows on any link, exactly as before this control existed — zero visual change until you opt in. Only nav links that actually carry a mega panel, disclosure panel, side drawer, takeover, or a simple-list dropdown pick up the arrow; a plain link (a bare URL with Opens left at its default and no sublinks) never shows one regardless of this setting, since there's nothing under it to signal. The arrow also rotates when the customer opens the panel it belongs to. Troubleshooting — no arrow on a link even with Chevron selected: check that the link actually has a panel or sublinks attached (its Opens field is something other than the default, or it's a Category Filter/Collection link with a panel — see the "Mega panels work on category links too" note above); a link with nothing configured under it has no panel to signal and stays arrow-less by design.
Icon shape — Cart, Wishlist, Account, and Search (Layout Axes)
Open Online Store → Theme → Page Layouts → Header, select your header row in the structure tree, and scroll the settings panel to Layout Axes. Four controls let you pick the visual style of the header's action icons, each independent of the others:
| Control | Options |
|---|---|
| Cart Icon | Default / Bag / Basket / Outline |
| Wishlist Icon | Default / Star / Bookmark / Ribbon |
| Account Icon | Default / Circle-user / Badge / Id-card |
| Search Icon | Default / Bold / Rounded / Square |
Leave a control on Default and that icon renders exactly as it always has — nothing changes until you pick a different option. The Search Icon control has one special case: Default always shows the classic magnifying-glass symbol your storefront has always used, even though the other three options switch to a matching line-icon design. Search Icon only appears on templates that have a search bar (Centered Logo Split Nav, Minimal Hamburger Bar, and Serif Luxury Bar don't, so those three templates show only the other three controls). These controls are purely cosmetic — they never change what the button does, only how it looks.
Troubleshooting — I picked an Account Icon and don't see it on the storefront: the account icon only renders once a customer is signed in, on templates that show separate Login/Sign up buttons for guests (most templates do). Sign in to preview it, or check a template that doesn't pair Login/Sign up buttons with the account icon.
Some links are locked
System links like Login and Orders are locked to prevent accidental removal — you can still reorder them, but you can't delete them from the navbar.
Empty link list falls back to Home / Shop / About
If you haven't added any navigation links yet, the header shows three default links — Home, Shop, and About — instead of an empty navbar. Add your own links above and they replace this fallback.
Utility Bar
Contact details and quick links shown in a slim strip above your main navigation. Every one of the 11 header templates can carry a Utility Bar row today — it isn't limited to Two Tier Utility Bar, Masthead, and Dept Store any more. Side Rail renders it as its own strip alongside the vertical column rather than nesting it inside the rail (the rail has no horizontal "above" to stack a strip on top of), and Transparent Overlay renders it as part of the same floating bar that solidifies on scroll. Two Tier Utility Bar, Masthead, and Dept Store still have their own bespoke, hand-styled strip layout (unchanged); the other 8 templates render a shared, generic Utility Bar strip.
Screen: Online Store → Theme → Page Layouts → Header, then select the Utility Bar row in the sidebar tree — it's only present once you've added the row (Two Tier Utility Bar, Masthead, and Dept Store carry it natively from the moment you switch to that structure; on any other template, add it via the Add tier (+) control in the sidebar, or the Guided setup dialog's Rows step above). The fields below render directly in that panel and autosave — there's no Save button on this panel; each edit is saved automatically about 600ms after you stop typing, and a small Saving spinner next to the "Utility bar" heading confirms it's in flight.
| Field | What it does |
|---|---|
| Contact phone | Rendered as text in the utility strip (Two Tier Utility Bar only) |
| Contact email | Rendered as text in the utility strip (Two Tier Utility Bar only) |
| Location address | Rendered as text in the utility strip (Two Tier Utility Bar only) |
| Locale label | A short label like "EN / USD" shown in the utility strip |
| Utility policy links | A label/URL list (e.g. Shipping, Returns, Track Order) shown in the utility strip |
| Utility menu links | A second label/URL list, kept separate from Utility policy links so you can group items (e.g. a "Track order" quick link) without mixing them into your policy list |
| Utility account links | A label/URL list for account-related shortcuts (e.g. "Sign in", "My account") |
| Utility social links | A label/URL list where the label field doubles as the platform name (e.g. type "Instagram" as the label and your profile URL as the link) |
| Current language | A short text field (e.g. "EN") for a language indicator in the strip |
| Current currency | A short text field (e.g. "USD") for a currency indicator in the strip |
| Utility bar message | A single line of free text (e.g. "Free shipping over $50") |
| Message link | The URL the utility bar message links to when clicked; leave blank for plain, non-clickable text |
Each list field (menu, account, social links) uses the same Add link row-editor as Utility policy links: type a label and URL, click Add link, and the new row appears immediately below with its own delete control. There's no limit enforced in the editor UI, and rows autosave the same 600ms-after-you-stop-typing way every other field on this panel does — there's no separate save step per row.
Whether a rendered header actually displays these fields today depends on your chosen template's render mode. As of this write-up, the shared Utility Bar strip (all templates except Two Tier Utility Bar, Masthead, and Dept Store) renders these seven fields' underlying data through its preset variant switch (Contact strip / Menu strip / Selectors strip / Social strip / Split / Centered message) — pick the variant matching the field group you filled in (e.g. fill in Utility menu links and choose the Menu strip variant to see them appear) rather than expecting every field to render at once regardless of variant. If a field you filled in isn't showing up, check the Utility Bar row's Style controls for the variant selector first before assuming the save didn't work.
Additional content items (2026-09-02). These fields sit below the fields above, in the same panel.
| Field | What it does |
|---|---|
| Current language | Free-text, e.g. "EN". No dropdown of real store languages yet — this is a label you type. |
| Current currency | Free-text, e.g. "USD". Same as above — a label, not a live currency switcher. |
| Utility bar message | A short line of text for the strip, separate from the header Announcement bar. |
| Message link | Where the message goes when clicked. Leave empty for a message that isn't clickable. |
| Utility menu links | A label/URL list — additional links shown in the strip beyond the policy links above. |
| Utility account links | A label/URL list — e.g. "My Account", "Sign In". |
| Utility social links | A platform/URL list — the "label" column here is the platform name (e.g. "Instagram"), not a display label. |
| Alignment | Horizontal alignment of the strip's content — Theme default, Left, Center, or Right |
Theme default, and what it renders as per template
The Alignment select's first option is Theme default, not a pre-selected side — leaving it untouched saves nothing for this field, and the storefront falls back to the template's own built-in alignment. On the 8 templates that share the common utility-strip renderer, Theme default renders centered on phones, right-aligned from tablet width up. Two Tier Utility Bar, Masthead, and Dept Store each read this same field but keep their own bespoke default when it's unset — Two Tier Utility Bar centered (centered-right from tablet width up), Masthead centered on both mobile and desktop, Dept Store right-aligned on both. Picking Left, Center, or Right explicitly overrides the template's default on all 11 templates alike.
These new fields need a Top Bar Content pick to show up
Current language, Current currency, Utility bar message/link, and the three new link lists render only once you set Top Bar Content (in Layout → Layout Axes, under Announcement & Utility Bars as Their Own Rows — see that section later in this guide) to something other than Contact info. With Top Bar Content left on Contact info (the default), the strip shows only Contact phone/email, Location address, Locale label, and Utility policy links, exactly as before these fields existed — that's by design, not a bug, and keeps every existing store's utility strip byte-identical until a merchant opts in.
Limitation: this Top Bar Content control itself only has somewhere to render once Announcement & Utility Bars as Their Own Rows is set to Stacked — see the callouts on that control later in this guide. On a header that instead uses one of the 11 premium header templates' own tier rows (the sidebar-tree Utility Bar row documented above), these six fields don't render yet regardless of any Layout Axes setting — that wiring is a follow-up.
The classic location now bridges here for premium-family stores
Once your store has published one of the 11 premium header templates, Online Store → Theme → Header (the classic Header editor's Navbar tab) no longer shows Menu links, navigation panels, or Utility Bar fields directly — all three are replaced there by a single "Header settings have moved into the page editor" card, with an Edit Header button. That button always lands you on the Main bar row (not this Utility Bar row) — if you're looking for the Utility Bar fields specifically, click Utility Bar in the sidebar tree once you arrive (it only appears once your structure has one). Stores still on the legacy (classic, pre-template-picker) header keep the full set of fields at the old location, unchanged — the bridge card only appears once you've published a premium template.
Add a delivery pincode check to the Utility Bar
The Delivery pincode check block lets a customer test a six-digit delivery pincode without leaving the page. It is a Utility Bar block only: the editor does not offer it on Announcement, Header Navbar, Sub-nav, rail, flyout, or mega-menu surfaces.
Open the Utility Bar row
Go to Online Store → Theme → Page Layouts → Header, then select Utility Bar in the left structure tree. If the row is not present, add it with the Add tier (+) control or include it in the Rows step of Guided setup.
Choose the zone for the check
Open Content. Under Start, Center, or End, click Add block. The zone controls where the form sits within the Utility Bar.
Add Delivery pincode check
In the Commerce group, choose Delivery pincode check. This choice is intentionally absent from every other header row's picker because the live form is supported only in the Utility Bar.
Write the customer-facing text
Open the new block and complete Label, Placeholder, and Button text. A new block starts with Check delivery, Enter pincode, and Check respectively. These three fields change the text around the form; the accepted value remains a six-digit pincode.
Save and publish the Header
Keep Keep this row's built-in layout on in Design to place the check alongside the row's normal content, or turn it off to show only your composed blocks. Make sure the Utility Bar row is shown, then save and publish the Header so customers receive the new block.
The editor preview cannot run the delivery check
Without the published storefront's live serviceability connection, the preview disables the input and button and shows Available on the published store. This is an intentional preview state; use it to review the label, placeholder, button copy, and placement, not to test a pincode.
Why don't customers see the pincode check?
Confirm the block is in the Utility Bar row, the row is shown for the customer's device, and the Header was saved and published. The editor will not offer this block in another row. If the form is visible but says We couldn't check delivery. Try again., the block is published but the shipping check could not return a carrier-confirmed result; follow Header delivery check troubleshooting.
Announcement
A one-line bar across the very top of your header — free shipping, a sale, a delivery cut-off. It's available on every one of the 11 header templates, including Transparent Overlay and Side Rail (the two templates that don't otherwise use the tier system) — add it the same way as any other row: the Add tier (+) control in the sidebar, or the Guided setup dialog's Rows step.
Screen: Online Store → Theme → Page Layouts → Header (mode switcher set to Desktop), just below Utility Bar (if present — Announcement doesn't require a Utility Bar row to also exist). If your store uses a premium header template, this section instead shows an Edit Header banner that takes you into the page editor — open HEADER from there and select the Announcement row in the structure tree on the left; it's the same fields either way.
| Field | What it does |
|---|---|
| Message | The line shown in the bar. Kept to one line — long text is trimmed on phones. Empty by default. |
| Link (optional) | Where the bar goes when a customer clicks it (e.g. /collections/sale). Leave empty for a bar that isn't clickable. Ignored in Countdown mode. |
| Behaviour | Static (one fixed message), Marquee (the message scrolls across), Rotating (cycles through several messages), or Countdown (time remaining to a deadline) |
| Messages (one per line) | Rotating only. Each line becomes one message; they cycle every few seconds. With none entered, the single Message above is used instead. |
| Navigation controls | Rotating only. None (default), Arrows, Dots, or Both — lets a customer manually step through the messages instead of only waiting for the auto-rotate. With only one message entered, no controls show even if this is set to something other than None. |
| Scroll speed | Marquee only. Slow, Medium (default), or Fast — how quickly the message scrolls across the bar. |
| Counts down to | Countdown only. The deadline. Required — see the edge cases below. |
| Label before the timer (optional) | Countdown only. Text shown before the running clock, e.g. "Sale ends in." |
| Countdown display | Countdown only. Compact, Verbose, or Colon — how the remaining time is formatted (e.g. 2d 04h vs. spelled-out units vs. 02:04:33). |
| Countdown icon | Countdown only. No icon (default), or one of five fixed glyphs: Clock, Hourglass, Bolt, Tag, Sparkle — shown next to the running clock. |
| Icon position | Shown once a Countdown icon is set. Before the timer (default) or after it. |
| Button label (optional) | Text for a call-to-action button in the bar. The button shows only when both Button label (optional) and Button link are filled in. |
| Button link | Where the button goes. A label with no link (or a link with no label) shows no button. |
| Button opens in | Same tab or New tab. |
| Background image | Opens the media picker to set an image behind the bar; use its reset action to remove it. |
| Let customers close the bar | Adds a dismiss (×) button. Dismissing only hides the bar for that visit — it's back on the customer's next page load or visit, nothing is remembered. |
| Alignment | Horizontal alignment of the bar's content — Theme default, Left, Center, or Right |
Compose linked rotating announcements
Use an Announcement block when each rotating message needs its own destination rather than one shared link for the whole bar.
Open the Announcement Bar row
Go to Online Store → Theme → Page Layouts → Header, then select Announcement Bar in the left structure tree. Add the row first with Add tier (+) or Guided setup if your structure does not already contain it.
Add an Announcement block
Open Content. In the Start, Center, or End zone where you want the message, click Add block, then choose Announcement from the Text group.
Set the block to Rotating
Open the block and set Mode to Rotating. Click Add message for every item, then fill in that item's Message and optional Link. Each displayed message opens its own Link. Add at least two messages to make the block auto-advance.
Choose whether built-in content remains
Blocks sit alongside the row's built-in layout by default. To replace the built-in announcement, open Design and turn off Keep this row's built-in layout.
Save and publish the Header
Review the order and destinations, then save and publish. The published Header cycles the linked messages and gives customers a pause control automatically.
Move the built-in announcement into a zone
When a retained Announcement Bar row has an Announcement block in its Start, Center, or End zone, the row's own message (including a Marquee, and its pause control) is shown inside the first visible Announcement block instead of at the row's default position, so it appears once, in the region you chose. Only the first visible Announcement block in the row is drawn this way; further ones in the same row are not rendered while Keep this row's built-in layout is on. The message shown is the row's own (set under the row's Content); the block's own Message fields are not used while the row's built-in content is retained, and if the row has no message of its own the block shows nothing. To show the block's own messages instead, turn off Keep this row's built-in layout under Design. Removing the block returns the message to its default position.
Pause and reduced motion are automatic accessibility behavior
A multi-message Rotating announcement shows a Pause announcement button; after a customer pauses it, the same control becomes Play announcement. Marquee announcements receive the same pause/play control. If a customer's device requests reduced motion, moving announcements start paused and the control begins as Play announcement. There is no merchant switch to remove or override this behavior: it prevents continuing motion from being forced on customers and respects their device accessibility preference. A Rotating block with only one message has no pause button because it does not auto-advance.
Theme default renders centered
The Alignment select's first option is Theme default, not a pre-selected side — leaving it untouched saves nothing for this field, and the bar renders centered, the same as it's always looked. Pick Left, Center, or Right explicitly to override that. Unlike the Utility Bar's Alignment control (which has three bespoke-template exceptions), this one applies identically on all 11 header templates that can carry an Announcement row.
Bar geometry. Four more fields, below Alignment in the same group, controlling the bar's own size and spacing rather than its content:
| Field | What it does |
|---|---|
| Bar height (px) | Overrides the bar's height. Leave blank to keep the default 36px |
| Content gap (px) | Space between the message/logo and the other elements in the bar |
| Ticker gap (px) | Marquee behaviour only. Space between one repeat of the scrolling message and the next |
| Content max width (px, optional) | Caps and centers the message row instead of letting it span edge to edge; leave blank for full-width |
Button (optional).
| Field | What it does |
|---|---|
| Add a button to the bar | Off by default — the bar has no button until you turn this on. Turning it on works even when Button label and Button link are both still empty — it just reveals the two fields below; nothing is saved yet at that point. |
| Button label | Shown once the button is on. The text on the button. |
| Button link | Shown once the button is on. Required — the storefront hides the button entirely until this is filled in, even with a label set. |
| Opens | Shown once the button is on. Same tab (default) or New tab. |
Turned the button switch on but nothing saved, or no button shows on the storefront?
The switch itself never fails to save, but the button configuration only reaches the server once both Button label and Button link have something typed in — a half-filled draft (label only, or link only) is held locally in the editor and isn't sent until the second field is filled in too. Fill in both fields, then check Save (and Publish, on a premium template) the same way as the general "Why don't customers see my announcement bar?" note above.
Bar behaviour (optional).
| Field | What it does |
|---|---|
| Keep the bar visible while scrolling | Off by default. On makes the bar stick to the top of the viewport as the customer scrolls, instead of scrolling away with the page. |
| Show a divider line under the bar | Off by default. Adds a thin bottom border under the bar. |
| Span the full browser width (ignore content max width) | Off by default. Off keeps the bar's content capped to your Content max width setting (in Bar geometry below, if set); on spans it edge-to-edge regardless, keeping only a slim inner gutter so the message and button never sit flush against the browser edge. |
Confirmed on the published storefront and the editor preview
The button and the three bar-behaviour switches above all reach both the published storefront and this editor's own live-preview canvas — unlike the Ground image and Inline logo fields below, there's no separate preview twin to catch up here. If a change isn't visible: confirm you clicked Save (and Published, on a premium template), then hard-refresh — same checklist as the general "Why don't customers see my announcement bar?" note below.
Ground image (optional). A background image for the bar itself.
| Field | What it does |
|---|---|
| Image URL | A full URL or a bare S3 asset key; the storefront resolves and signs a bare key automatically. Leave blank for no background image |
| Fit | Shown once an image URL is set. Cover (crop to fill) (default) or Contain (never crop) |
| Darken the image behind the text | Shown once an image URL is set. On by default — adds a scrim so the message stays legible over a busy photo |
Inline logo / mark (optional). A small image shown beside the message, separate from your main store logo.
| Field | What it does |
|---|---|
| Logo URL | A full URL or a bare S3 asset key. Leave blank and no logo shows |
| Logo link URL (optional) | Directly below Logo URL (optional). “Where shoppers go when they click the inline logo.” Set it to make the logo link to that URL; leave it empty and the logo stays non-clickable, as it did before this field was added |
| Alt text | Shown once a logo URL is set. Accessibility text for the image |
| Position | Shown once a logo URL is set. Before the message (default) or After the message |
| Height (px) | Shown once a logo URL is set. The logo's rendered height |
| Width (px, optional) | Shown once a logo URL is set. Leave blank to keep the aspect ratio implied by Height |
| Gap between text and logo (px) | Shown once a logo URL is set. Spacing between the logo and the message. Leave blank to use the bar's default content spacing |
Add the inline logo
Enter the image source in Logo URL (optional). Without a logo image, there is nothing on the storefront for a customer to click.
Set its click destination
In Logo link URL (optional) directly underneath, enter the page or URL customers should open, then save and publish the header. The published storefront turns the logo into a link to that URL.
A freshly added Announcement tier starts with all Announcement fields blank, including Logo URL (optional) and Logo link URL (optional). A logo destination from a previously configured or removed Announcement tier is not carried into the new tier; enter it again if the new logo should be clickable.
Why isn't my announcement logo clickable?
Check that Logo URL (optional) contains an image and Logo link URL (optional) contains the destination — the link field on its own has no logo to wrap, and an empty link deliberately leaves the logo non-clickable. If you recently added a fresh Announcement tier, re-enter both values, then click Save, Publish the header when required, and hard-refresh the storefront.
Ground image and inline logo don't show yet in the editor's own live preview
The ground image, inline logo, and logo click target are wired to the real storefront — saved values render correctly once you Publish. They aren't reflected in this editor's live-preview canvas yet (a separate preview component that hasn't caught up to these fields), so don't judge whether they saved by watching the preview here — check the published storefront instead.
Full-width scrolling ticker — a second Marquee presentation in a row block
Marquee mode above always scrolls a single message edge-to-edge (entering from off-screen and looping). A second presentation — a continuous, full-width ticker that repeats the message back-to-back with no gap or re-entry pause — exists as a Presentation control (Single message scroll / Full-width ticker), but it lives on the Announcement row's own content-block editor (open the row's Content tab and add or select the block), not in the fields above. Add an Announcement block to reach it; use the row's Design tab only for the block layout and Keep this row's built-in layout control.
Set your message
Type the line you want shown. While Message is empty (and, in Rotating mode, Messages is also empty), the bar doesn't render at all — there's no "on/off" switch, an empty message is the off state.
Pick a Behaviour
Static and Marquee both show the single Message — Marquee scrolls it, Static holds it still and truncates with an ellipsis if it's too long for the bar. Rotating and Countdown reveal their own extra fields once selected.
Fill in the mode-specific fields
Rotating: add one message per line. Countdown: set Counts down to and, optionally, a Label before the timer.
Turn on the dismiss button if you want one
Let customers close the bar adds the × control. Leave it off for a bar customers can't dismiss.
Countdown renders nothing without a date — and nothing once the date passes
Countdown mode needs Counts down to set; without it the bar doesn't show up at all, even with a Message and Label filled in. Once the deadline passes, the bar disappears too — including live, mid-visit, for a customer who already had the page open. There's no "expired" message state; plan your countdown target with that in mind.
Rotating with nothing in Messages
If you switch to Rotating but leave Messages blank, the bar falls back to showing the single Message field as a static line — it won't cycle through anything until you add at least one line to Messages.
This is not the page-builder Promo Banner or Announcement Bar section
This header Announcement bar is separate from the Promo Banner and Announcement Bar content sections available inside individual pages via + Add Section in the Section Library — those are page-content blocks you place and configure per page. This one lives in the header itself and shows on every page of your storefront once Message (or, in Rotating mode, Messages) is filled in.
Why don't customers see my announcement bar?
Check, in order: (1) Message isn't empty (Rotating mode also needs at least one line if you want cycling, otherwise it falls back to Message); (2) in Countdown mode, Counts down to is set to a future date/time; (3) you clicked Save on the Header editor, and Published the header if your store uses a premium template (Save Draft alone keeps it in the editor only); (4) you're not looking at a cached page — the bar renders on every load, so a hard refresh rules out a stale bundle.
Why don't my Countdown display, Countdown icon, Scroll speed, or Navigation control changes show up?
Every field above — Countdown display, Countdown icon and its Icon position, Scroll speed, and Navigation controls included — now reaches the published storefront. If a change you made isn't visible: (1) confirm you clicked Save on the Header editor, and Published it if your store uses a premium template (Save Draft alone keeps it in the editor only); (2) confirm the bar's Behaviour actually uses the field — Countdown display and the Countdown icon fields only apply in Countdown mode, Scroll speed only applies in Marquee mode, and Navigation controls only apply in Rotating mode; (3) hard-refresh the storefront tab — the bar renders on every load, so a stale cached bundle can hide a change that already saved.
Announcement & Utility Bars as Their Own Rows (Layout Axes)
By default the Announcement and Utility Bar rows above render inline with your header, folded into the same strip they've always used (Legacy). A separate opt-in switch turns them into their own full-width bands stacked around the Header Navbar instead, and unlocks eight more Layout Axes controls that only make sense once the bars are separate rows.
Not visible on this header? It's using its own tier stack instead
Most of this Layout Axes section — the master switch above, Announcement Bar Position,
Announcement Bar Behaviour, and Top Bar Position — only shows up when the header's structure
tree has no tiers configured. Once you've built a tier stack (added rows under Structure on the
header's own settings panel), those four controls disappear and are replaced by a single italic line
reading "This header uses a tier stack; row/placement controls don't apply.", because the tier-stack
renderer never reads any of them — showing controls with no effect would be misleading. To get back
to them, click the Remove tier stack link that appears just below that italic line — it clears
only the tier stack (config.tiers), leaving your colours, typography, and every other Layout Axes
override on this header untouched. This is different from the panel's own Reset all, which wipes
every override on the header, not just the tiers — use Reset all only if you mean to start this
header completely over.
Exception (2026-09-03): on the 8 templates that use the shared Utility Bar row (Centered Logo Split Nav, Floating Pill Navbar, Minimal Hamburger Bar, Retro Arcade Bar, Serif Luxury Bar, Side Rail, Tech SaaS Bar, and Transparent Overlay), Top Bar Content, Use full width, Show on mobile, Keep visible on scroll, Show separator line, and every control in Top Bar Style Axes below stay on the panel and render fully enabled on a tier-stack header — no "Requires Stacked" hint, no need to switch the (now-hidden) master switch to Stacked. The tier-stack renderer reads these directly, so they take effect on your tier stack's Utility Bar row immediately. Two Tier Utility Bar, Masthead, and Dept Store keep their own bespoke, hand-styled utility strip (see the warning below and the Utility Bar section above) and never show these controls at all, tier stack or not.
Screen: on your header's Config panel, open the Layout tab and scroll to Layout Axes. The master switch is:
| Control | Values | Effect |
|---|---|---|
| Announcement & Utility Bars as Their Own Rows | Legacy (default) / Stacked | Legacy is today's render, byte-identical to before this control existed. Stacked makes the Announcement and Utility Bar rows render as their own full-width bands: Announcement above the header (or wherever you place it below), then Utility, then your Header Navbar, then anything placed below it |
Existing stores keep their current look until you opt in
Legacy is the default for every store, including ones that already have Announcement or Utility Bar content saved — switching this on is what changes your layout, not the upgrade itself. There's no backfill and no automatic migration; this is a deliberate merchant choice.
Once Stacked is selected, eight more Layout Axes controls become interactive (they render
disabled, with a small italic hint underneath reading Requires "Announcement & Utility Bars as Their Own Rows" set to "Stacked", whenever the switch above is still Legacy):
| Control | Values | Effect |
|---|---|---|
| Announcement Bar Position | Above header (default) / Below Header Navbar / Page bottom / Hidden | Where the stacked Announcement row sits relative to the Header Navbar |
| Announcement Bar Behaviour | Static (default) / Rotating / Marquee / Countdown / Grid | Same four behaviours as the classic Announcement row above, plus a new Grid option: three independent zones (Left/Center/Right) of short text-and-link items instead of one scrolling message — configured in the row's own Grid Zones section (below) once you pick Grid here |
Bar still scrolling after you picked Static?
Static is the shown default the first time you open this control, so clicking Static to confirm it now always saves that choice explicitly — it used to be swallowed on the first click when Static was already the visibly-selected option, and the bar would then fall through to whatever behaviour is set on the classic Announcement row's own Behaviour field above (e.g. Marquee), which is why it kept scrolling even though the inspector showed Static. If you still see this on an older save, reopen the control and click a different option, then click back to Static to force it to persist.
| Top Bar Position | Own row above (default) / Below Header Navbar / Inline with Header Navbar / Hidden | Where the Utility Bar row sits. "Inline with Header Navbar" folds it into the header's action-icon area instead of giving it its own band, and is always hidden on mobile regardless of the "Show on mobile" control below | | Top Bar Content | Contact info (default) / Menu / Selectors / Social / Split / Centered message | Which Utility Bar fields show, and how they're grouped left/centre/right. Contact info is byte-identical to today's Utility Bar (Contact phone, Contact email, Location address, Locale label, Utility policy links only). The other five options draw from those same fields plus Menu links, Account links, Social links, Current language, Current currency, and Message (documented above) — see the callout below for exactly which fields each variant uses | | Use full width | Off (default) | Lets the Utility Bar row span edge-to-edge, keeping only a slim inner gutter so the end items never sit flush against the browser edge | | Show on mobile | On (default) | Whether the Utility Bar row also renders on the mobile header. Only this row is affected — the Header Navbar's mobile behaviour never changes | | Keep visible on scroll | Off (default) | The Utility Bar row sticks to the top of the viewport as the customer scrolls | | Show separator line | Off (default) | Adds a bottom border under the Utility Bar row |
Top Bar Position, Top Bar Content, and the other six controls above do nothing on Two Tier Utility Bar, Masthead, or Dept Store
These three templates keep the bespoke, hand-styled utility strip they've always had (see the Utility Bar section above) instead of reading from this Layout Axes row — that strip never consumed Top Bar Position, Top Bar Content, Use full width, Show on mobile, Keep visible on scroll, or Show separator line, and it still doesn't after this wave. Their strip only ever shows Contact phone, Contact email, Location address, Utility policy links, and Locale label (the same five fields as Contact info here), laid out in each template's own fixed style — Two Tier Utility Bar's strip spans the full row, Masthead's sits inside its slim top tier above the logo row, Dept Store's sits inside its own compact top tier. Troubleshooting — "why doesn't Top Bar Content change anything on my template?": check your header's template first. On Two Tier Utility Bar, Masthead, or Dept Store, switching Top Bar Content (or any of the other seven controls in this table) saves but has no visible effect, because these three templates never call the shared renderer these controls configure. Switch to one of the other 8 templates to use Top Bar Content's Menu, Selectors, Social, Split, or Centered message layouts.
Grid Zones — configuring the new Announcement grid
Once Announcement Bar Behaviour is set to Grid, a Grid Zones section appears on the Announcement row's own settings panel with three columns — Left, Center, Right. Each has an Add item button; every item gets a Text field, an optional Link field, a drag handle to reorder within its own column, and a delete icon. Items render side by side within their zone; an empty zone renders nothing. Content you author while Grid is selected is kept if you switch to another Behaviour and back — it only renders while Grid is the active Behaviour.
Which fields each Top Bar Content variant shows
Each non-default variant pulls a fixed set of fields into fixed left/centre/right slots — a field you haven't filled in is skipped, not shown blank:
- Menu — Menu links (left); Contact phone, Account links (right)
- Selectors — Current language, Current currency, Account links (right)
- Social — Social links (left); Message, Contact phone (right)
- Split — Contact phone, Contact email (left); Utility policy links, Current language, Current currency, Account links (right)
- Centered message — Message (centre only)
If you switch Top Bar Content and a zone looks empty, it's because none of that variant's fields are filled in yet — fill in the relevant field(s) above (Menu links, Account links, Social links, Current language, Current currency, or Message), or switch back to Contact info.
On a narrow screen, overflowing items collapse into a More menu instead of clipping
Menu, Selectors, Social, Split, and Centered message all lay their items out in the same left/centre/ right zone strip, and at narrow widths (a small laptop or a merchant with a long phone number, long menu labels, or a bumped-up font scale can all trigger it — it's not just a phone-sized breakpoint) there isn't room for every item at full size. Whichever items stop fitting collapse into a More button at the end of the row instead of being squeezed down to an unreadable, untappable sliver; clicking or tapping More opens a small panel listing the collapsed items so links and account actions stay reachable. This applies to every Top Bar Content option except the default Contact info — that strip keeps its original hard-clip/ellipsis behaviour unchanged, so an existing store that has never touched Top Bar Content renders exactly as it did before.
Why are these controls greyed out?
On a Legacy-row header (no tier stack), all eight controls above stay disabled, with the reason spelled out under each one, until Announcement & Utility Bars as Their Own Rows is set to Stacked. Set that first — the dependent controls unlock immediately, no save or reload needed.
On a tier-stack header, this only applies to Announcement Bar Position, Announcement Bar Behaviour, and Top Bar Position — and since the master switch itself is hidden there (see the callout above), those three are hidden too, not merely disabled. Top Bar Content, Use full width, Show on mobile, Keep visible on scroll, and Show separator line are the exception: they render enabled with no hint, because the tier-stack renderer consumes them directly.
Top Bar Style Axes (Layout Axes)
A further 14 Layout Axes controls (2026-09-03) restyle the Utility Bar row itself — scrolling/paging behaviour, typography, a border set, and icon styling. They live in the same Layout tab, Layout Axes list, directly below the eight controls above.
On a Legacy-row header, all 14 share the same gate as the eight controls above: they render
disabled until Announcement & Utility Bars as Their Own Rows is set to Stacked, with the
same Requires "Announcement & Utility Bars as Their Own Rows" set to "Stacked" hint underneath. On
a tier-stack header, all 14 are the exception described in the callout at the top of this
section — they render enabled with no hint and restyle the stacked Utility Bar row directly,
even though the master switch that normally gates them is hidden on that header.
Display mode
| Control | Values | Effect |
|---|---|---|
| Top Bar Display Mode | Static (default) / Marquee / Slider | Static is today's fixed-position strip (the zones/legacy layout described above), unchanged. Marquee scrolls the same content items continuously in one direction. Slider pages through the items one at a time instead of scrolling continuously |
Marquee and Slider bypass Top Bar Content and pool every filled-in field
Setting Top Bar Display Mode to Marquee or Slider is checked ahead of, and overrides, the Top Bar Content variant split — it doesn't matter which of Contact info/Menu/Selectors/Social/Split/ Centered message is selected. Instead, Marquee and Slider pull in every field you've filled in across the whole Utility Bar panel at once (Contact phone/email, Location address, Locale label, Utility policy/menu/account/social links, Current language/currency, Utility bar message) and scroll/page through all of them together. If none of those fields are filled in, Marquee and Slider render nothing at all.
Typography
| Control | Values | Effect |
|---|---|---|
| Top Bar Font | Inherit (default) / System UI / Georgia (serif) / Courier New (monospace) | Overrides the utility strip's font family. Inherit leaves it following your theme's body font, unchanged |
| Top Bar Font Size (px) | 9–20, default 12 | Text size for the whole strip |
| Top Bar Font Weight | 400 / 500 (default) / 600 / 700 | Text weight for the whole strip |
| Top Bar Letter Spacing (px) | -1 to 4, default 0 | Letter spacing applied to the strip's text |
| Top Bar Line Height | 1 to 2, default 1.2 | Line height applied to the strip's text |
Border
| Control | Values | Effect |
|---|---|---|
| Top Bar Border Style | Solid (default) / Dashed / Dotted | Style of the strip's border |
| Top Bar Border Width (px) | 0–6, default 1 | Border thickness. 0 renders no border regardless of style/colour |
| Top Bar Border Color | Colour picker, blank by default | Border colour. Left blank, no border colour is applied even if width/style are set |
| Top Bar Border Radius (px) | 0–24, default 0 | Rounds the strip's corners |
This is a separate control from the existing Show separator line toggle
The classic Show separator line toggle above only ever draws a bottom border. This new border set (style, width, colour, radius) is additive and controls the strip's full border on all sides — the two can be combined, since they apply through the same style object rather than replacing one another.
Icon
| Control | Values | Effect |
|---|---|---|
| Top Bar Icon Size (px) | 10–32, default 16 | Size of icons rendered in the strip's items (e.g. social icons) |
| Top Bar Icon Color | Colour picker, blank by default | Icon colour. Left blank, icons keep their default colour |
| Top Bar Icon Spacing (px) | 0–24, default 6 | Gap between an icon and its adjacent text/label within an item |
| Top Bar Icon Position | Left (default) / Right / Above | Where the icon sits relative to its item's text — before it, after it, or stacked above it |
Why don't I see any icons to style?
As of this write-up, none of the Utility Bar's own content items (Contact phone/email, Location, Locale, Utility policy/menu/account/social links, Current language/currency, Utility bar message) render with an icon glyph on any Top Bar Content variant — Utility social links, for instance, render as plain text labels, not icons. These four controls save correctly, but have no visible effect today regardless of which items or Top Bar Content variant you've set, because nothing in the strip's content currently carries an icon to style. They're wired for a future item type that does carry one.
Bar Height (Layout Axes)
The header's own Header Navbar has a height field in its Layout Axes list — every template except Side Rail shows it, labelled to match that template's own vocabulary for the bar (for example Floating Pill Navbar calls it "Pill Height", Masthead calls it "Section Ribbon Height", and every other template calls it "Header Height" or "Main Bar Height").
Screen: the same Layout tab's Layout Axes list as Spacing Rhythm and Top Bar Style Axes above.
| Control | Values | Effect |
|---|---|---|
| Header Height / Pill Height / Main Bar Height / Section Ribbon Height (px) | 40–200, blank keeps the template's own default | Sets the main bar's height directly. Also scales the mobile bar/ribbon to match. Transparent Overlay is the one exception: this field changes the bar's own height but does not change the page-content offset reserved beneath it, which stays zero on that template |
A short value looked like it was being ignored
Setting this below roughly 76px used to render at a taller, floored height on some templates instead of the value you typed — that floor is gone; any value from 40px up now takes effect exactly as set. If your header still looks taller than the number you entered, check whether Spacing Rhythm above is also set — Spacing Rhythm scales the bar height too, and the two combine.
Search Style (Layout Axes)
A separate control changes how the search box itself is presented when Search is enabled.
Screen: the same Layout tab's Layout Axes list as above.
| Control | Values | Effect |
|---|---|---|
| Search Style (used when Search is enabled) | Icon (opens overlay) (default) / Inline bar / Takeover | Icon shows a small search icon that opens a search overlay. Inline bar shows a persistent search field in the header itself. Takeover expands the search into a full-screen overlay with a trending-searches chip row and a "Popular right now" product preview beneath it |
Trending searches and Popular right now (Takeover only)
On the Takeover style, the search overlay shows a row of trending-search chips plus a "Popular right now" preview grid for the top trending term. These are backed by the store's own search history over the trailing 30 days, falling back to the store's most recently added active products if there's no search history yet. The preview grid is a fixed snapshot of that one term's products — it does not update live as the customer types, since the overlay doesn't yet forward the typed query back to the storefront app.
Why can't I change Search Style?
Three header templates — Centered Logo Split Nav, Minimal Hamburger Bar, and Serif Luxury Bar — don't expose this control yet; their search always uses the Icon presentation. Every other header template shows Search Style in its Layout Axes list.
Logo Height (Layout Axes)
Two ways to size your logo inside the header bar — an exact pixel height, or a percentage of the bar's own height so the logo scales automatically if you later change the bar's height.
Screen: the same Layout tab's Layout Axes list as above.
| Control | Values | Effect |
|---|---|---|
| Logo Height (px) | Blank (default), 12–160 | An exact pixel height for the logo image. Blank keeps the stepped Small / Medium / Large size set elsewhere on this template |
| Logo Height (% of header bar height) | Blank (default), 30–100 | The logo's height as a percentage of this bar's own resolved height — a slider with an adjoining number field next to it; drag the slider or type an exact number, and it snaps back to the nearest allowed value (30–100) if you type outside that range. Blank keeps whichever of Logo Height (px) or the stepped size otherwise applies |
Logo Height (%) always wins if both are set
The two fields are the same control at two resolutions, not two independent settings. If you set both Logo Height (px) and Logo Height (%), the percentage is what renders — the pixel field stays saved and visible, but has no visible effect until you clear the percentage. Percentage wins deliberately: it's the one that stays correct if the bar's own height later changes (a custom Bar Height value, or Shrink Header on Scroll), so it takes priority over a fixed pixel value that can't adapt. If you only ever set one, that one applies normally.
Not available on Side Rail
Side Rail is the one header template (of 11) with no bar-height axis of its own — its Header Navbar doesn't work in a fixed height the way the others do, so there's nothing for a percentage to be a percentage of. Neither Logo Height field appears in its Layout Axes list; every other header template shows both.
Why doesn't my Logo Height (px) change anything?
Check whether Logo Height (%) also has a value set on this template — the percentage always overrides the pixel value, even if you set the pixel value more recently. Clear Logo Height (%) (leave it blank) to let the pixel value take effect.
Space After Logo
The Header's Layout Axes list has Space After Logo (0-96px, steps of 2; blank keeps the design's own rhythm), the gap between the logo and the navigation. It is hidden, not dimmed, on the centred-navigation and stacked header arrangements, where the navigation sits in the centre and a gap after the logo does not apply. If you do not see it, check the header arrangement.
Edit the Header Brand block
Go to Online Store → Theme → Page Layouts → Header → Header Navbar. In the navbar slot layout, select Edit logo on the Brand block. The inspector splits the block's controls across the same task lenses used elsewhere:
| Lens | Control | Customer-facing effect |
|---|---|---|
| Content | Current store name and Change in Site-wide → General | Shows the store name that supplies the Header wordmark; the pointer opens the one store-wide field instead of duplicating it here |
| Content | Logo display — Current design, Image, Brand name, or Image and brand name | Chooses whether customers see the uploaded image, the store name, or both |
| Content | Tagline | Sets the optional Header tagline text. When shown, it stacks directly under the brand name instead of beside it |
| Content | Link | Sets the destination opened when a customer selects the logo/brand |
| Design | Logo size for desktop and mobile | Sets the image size independently for each viewport. This and Layout Axes Logo Height control the same size, so the last one you edit wins: editing one clears the other |
| Behaviour | Show tagline | Shows or hides the saved tagline without deleting its text |
If no store name exists, the Content lens says No store name set; select Change in Site-wide → General and enter it there. Logo size (16 to 240 px) is enabled whenever the header has a logo to draw: an image set on the header itself, a logo in the Header Navbar's unsaved branding draft, or the store's saved logo from Site-wide → Branding. With none of those it stays disabled, with the prompt Upload a logo in Site-wide → Branding to change image size. Upload the shared asset there, return to the Brand block, set the display and sizes, then select the top-bar Save action.
Edit logo remains available without a Logo block
Some header templates render their built-in brand without a separate Logo block in the structure tree. You do not need to add one: use Header Navbar → Brand → Edit logo to open the same brand-name, display, tagline, link, and size controls. Merely opening that panel does not add a Logo block or create an unsaved draft; the draft changes only when you edit a value.
The Header still shows text after you chose Image
Confirm Site-wide → Branding has a logo image, then return to Header Navbar → Brand → Edit logo. Without an uploaded image the size controls stay disabled; use Brand name or Image and brand name only when the store-wide name is also set in Site-wide → General.
Legacy header logo image (Media tab)
The legacy template picker also has a template-specific logo-image override, independent of the current Store Editor Brand block above and of your footer logo. Swapping this legacy override does not upload or replace the store-wide logo.
Screen: open Header from the Page Layouts journey rail, select your header template, then switch the picker's sub-tab row from Content to Media.
| Control | Effect |
|---|---|
| Logo image thumbnail | Shows the currently-resolved image once it's a full http(s):// URL — blank if the template has no image set yet, or if the URL doesn't load |
| Choose image | Opens the asset library to pick or upload an image; sets it as this header's logo |
| Logo image (URL field) | A plain text field for pasting a URL directly — useful for a curated/CDN link instead of uploading through the library |
| Reset icon (↺) | Appears only once you've changed the image from the template's built-in default. Clicking it removes your override |
Resetting does NOT bring back your branding logo
Clicking the reset icon does not restore your store's main branding logo (the one set on Store Branding) into the header. It removes the header's logo image entirely — the header renders your store name as text only, with no logo image, until you set a new one here via Choose image or the URL field.
Why does my header show no logo at all?
If the header bar shows only your store name in text with no image, either no logo has been set on this header's Media tab yet, or one was set and then reset. In both cases the header does not fall back to your store's main branding logo — check the Media tab on this header template and set an image there directly.
The Mega Menu master switch (Theme Settings → Features)
Before authoring any mega or disclosure panel, there's one store-wide switch that has to be on: Online Store → Theme → Page Layouts → Header → Theme Settings → Features → This template → Mega Menu. It's a plain on/off toggle, on by default for every store that hasn't touched the Features list before.
| What it does | Detail |
|---|---|
| ON (default) | Every authored mega panel and disclosure panel (both systems described below) renders on the live storefront once you Publish |
| OFF | Every authored panel on every nav link is hidden on the storefront, even if it's fully configured — the panels aren't deleted, they just don't render until you turn this back on and Publish |
If you've ever touched Features before, check this switch first
This switch is new to the Features list as part of the 2026-08-29 mega-menu authoring redesign. A store that had never saved anything from the Features list before this rollout gets it ON automatically. But if your store had saved any Features toggle at any point in the past (for example, you'd previously turned Search or Wishlist off), your store's saved settings can't contain a switch that didn't exist yet — so Mega Menu loads OFF for you even though it's meant to default on. If your mega panels or disclosure panels stop showing on the storefront after this rollout and everything else looks correctly configured, this is almost always why: open Features, turn Mega Menu on, and Publish.
Why don't my panels show at all?
Check, in this order: (1) Theme Settings → Features → Mega Menu is ON (see the callout above — this is the most common cause right after this feature shipped); (2) the link actually has a panel configured — its row shows a Dropdown or Mega indicator once one exists; (3) you clicked Save panel inside the panel editor, and then Published the header — Save Draft alone keeps it in the editor only.
Mega panels: a multi-column dropdown with a promo image
Mega panels are configured from the link they belong to; there is no separate Mega Panels list below Menu links, and there are no per-link Configure buttons anymore. Go to Online Store → Theme → Page Layouts → Header → Header Navbar → Navigation → Menu links, then use either entry path:
- While adding or editing a link with a stable destination, set Opens to Mega panel.
- On a saved link, open More actions → Make mega menu.
After the link is saved, its row shows a Mega indicator. Once the panel has authored content, selecting that indicator opens the same panel editor directly. The selected mega panel also opens on the canvas automatically while you edit it, so you can see the columns and image tile without turning on Show open. Leaving the panel selection returns the canvas to its normal interaction; Show open remains available when you deliberately want the panel held open.
| Control | What it does |
|---|---|
| Add column / remove column | Each column is an independent group inside the dropdown panel |
| Column heading (optional) | A heading label for that column, e.g. "Bestsellers"; leave blank for a headless column of plain links |
| Column heading link (optional) | Makes the column heading itself clickable |
| Add entry / remove entry (per column) | Each entry has a Label, a URL, an optional one-line description shown under the label, and an optional badge (e.g. "New") |
| Include promo tile | Turns on a promotional image block that sits alongside the columns — image URL, optional heading, optional subheading, optional CTA label, and an optional link for the whole tile |
| Save panel | Commits your edits for that nav item; Save Draft / Publish on the Header editor still governs when customers see it |
A separate Mega Panel Width control (Card / Full Width / Full Bleed) lives in Theme Settings → Layout, not inside the per-link panel editor — it applies to every mega panel on your header at once, controlling how wide the dropdown panel renders relative to the page: Card keeps it a contained width, Full Width stretches it to the header's own width, and Full Bleed stretches it edge-to-edge of the browser viewport.
Save panel blocks incomplete or empty authored content
Every entry needs both a Label and a URL to be kept. If you type a label and leave URL blank, the URL field shows an inline error, and clicking Save panel now shows an "Add a URL before saving" dialog naming the offending entry instead of saving — nothing is discarded silently. Fill in the URL or delete the entry, then save again. A titled column with no complete links is also blocked by Add content before saving, and a panel with no complete link, band, or promo tile is blocked as having no usable content. Add complete content or use Remove disclosure panel.
An empty saved panel is a status, not an editor shortcut
Configuring a mega panel for a nav item makes it supersede that link's own (older, flat) dropdown — every other link keeps rendering whatever it rendered before. A persisted panel seed with no authored columns may show Mega or Dropdown on the row, but that status is deliberately not clickable because it has nothing to render yet. Use More actions → Make mega menu or Make dropdown to return to its composer and add usable content.
Why don't I see my promo image or badge?
Both are opt-in per nav item — nothing shows until you explicitly fill in the promo tile's image URL or a column entry's badge text for that specific link. If you've filled them in and still don't see them, confirm you clicked Save panel inside the dialog (it stays local until then) and then Publish the header from the top of the Header editor — Save Draft alone keeps changes in the editor only.
Mega-panel image tile captions, open icon panels and sticky footers
Caption a flush image tile
In the mega panel dialog set Flush image to a placement, then fill the tile's Eyebrow (optional), Subheading (optional) and CTA text (optional) (the caption only renders when Heading, Subheading, or CTA text is set). Choose Caption overlay to lay the caption over the image on a fading dark scrim, or Caption below image to put it underneath. A flush tile with no caption renders exactly as before.
Open header icon panels
Panels opened from header icons are no longer clipped by the header bar, and the shared menus clamp to the screen edge and flip upward when there is no room below.
Footer Sticky Behavior
Footer templates carry a Sticky Behavior dropdown with the values none, always and reveal-at-end; the Store Editor shows them as None, Always and Reveal at end. Only Always and Reveal at end make the footer fixed. In those modes the page reserves the footer's measured height, so there is no empty space below the footer and the last content scrolls clear of it. Inline and banded footers stay in normal page flow, which removes the old blank gap below them. With None nothing changes.
Why does Image fit do nothing on my captioned tile?
A flush tile whose caption is set to Caption overlay is edge-to-edge, with the scrim laid over the photo, so it always fills the whole tile (cover, cropping any overflow) whatever Image fit says; letterboxing the photo would leave the scrim over empty space. Image fit (and Focal point, which still steers what stays visible) only take effect on a tile with Caption below image, or a tile with no caption. To show the whole photo uncropped, switch the caption to Caption below image and set Image fit to Fit inside (no crop).
Why does my tile show no caption?
Nothing renders until Heading, Subheading or CTA text is set, and only flush tiles use the overlay scrim. An ordinary (non-flush) tile keeps its existing look.
Disclosure panels: a second, richer dropdown type
The same editor supports Dropdown panel, Mega panel, Side drawer, Full-screen takeover, and Side rail. It opens when you choose one from the link's Opens control, or when you choose Make dropdown or Make mega menu from More actions. It can layer on top of, or replace, a link's legacy mega panel data.
Screen: Online Store → Theme → Page Layouts → Header (Desktop mode), or the page editor's Main Bar → Navigation → Menu links. Select a saved row to edit Opens, or use that row's More actions menu.
The editor now opens as a wide (640px) side drawer rather than mounting inline in the narrow settings rail, so there's real room to work — organised into three sections plus a collapsed Advanced accordion:
How it opens
| Control | What it does |
|---|---|
| Panel style | How the panel opens: Attached dropdown (small panel under the link), Full-width mega (wide multi-column panel), Side drawer (slides in from the side), Full-screen takeover, or Side rail |
| Open on | Hover, Click, or Hover or click |
| Panel width | Boxed (contained), Full width (header's width), or Full width, edge-to-edge (edge-to-edge of the browser) — a separate width setting from the Mega Panel Width axis above, scoped to this one panel |
| Color mode | Inherit (the default — no override, follows the header's own colours), Match header, Inverted, Brand color, or Transparent |
Appearance
The visible layout controls for this panel — column/tile spacing and similar presentation settings. Below them, an Advanced accordion (collapsed by default) holds the finer, less commonly touched geometry controls: corner radius, minimum height, and panel width/max-width in pixels — these used to sit always-visible in this card; they're tucked away now so the everyday controls aren't crowded by settings most stores never need to touch.
Also inside Advanced: a Show dividers between columns toggle. Off (the default) shows no divider at all — an unset panel renders exactly as it always has. Turned on, it draws a thin vertical rule between each column, and — once a panel has enough columns that they wrap onto more than one row (a narrow panel width, or many columns at once) — the same toggle also draws a horizontal rule between the wrapped rows, so every row reads as visually separated from the next. It's one switch driving both the vertical and horizontal rule; there's no separate control for each. Has no visible effect on a single-row panel with only one column, since there's no second column or row for a rule to sit between.
Panel content
| Control | What it does |
|---|---|
| Add link column | Adds a column of links, each with a Label, URL, optional description, and optional badge (short marker chip, e.g. "New"), plus a per-link icon, trailing icon, and numeric count badge |
| Column → Text alignment | How the column's content sits on the panel's cross-axis: Automatic (recommended) (the built-in default — panel columns anchor to the top, bar rows stay optically centred), Left, Center, Right, or Baseline. Use this to, for example, bottom-align a short column of links against a taller neighbour, or centre a column's contents vertically. Automatic is the same as never touching this control — it doesn't write anything to your panel until you pick a real value |
| Column → Column width | Only shown once a panel has two or more columns. A number from 1-12 controlling how much of the panel's leftover width this column claims relative to its siblings — a column set to 2 beside two untouched columns takes roughly twice their share. Leave every column blank and they split the space evenly, exactly as before this control existed. This does nothing on a panel whose columns are already forced to equal widths (an authored equal-columns/grid layout) — the ratio has no gap left to distribute there. Still a plain numeric field today, not (yet) a Narrow/Normal/Wide preset picker |
| Link → Size (optional) | Per-link font-size override in pixels (10-72). Leave blank and the link uses the panel's own default size |
| Link → Hover image URL (optional) | Swaps the panel's promo image (the Add image tile below) to this image while the customer hovers this specific link — a full URL or a bare S3 asset key. Has no visible effect if the panel has no image tile to swap |
| Add image tile | Adds a single promotional image alongside your link columns — Image URL (a full URL or a bare S3 asset key; the storefront resolves and signs a bare key automatically), optional Heading, and optional Link for the whole tile. Only offered on panel kinds/widths the storefront can actually render a tile on — hidden, not shown-and-broken, when it can't |
| Image tile → Flush image | Where the tile sits relative to your link columns: No flush media (the default — the original, always-safe stacked-band layout below the columns), Image on the left, edge-to-edge, or Image on the right, edge-to-edge. The two edge-to-edge options run the image full-height against that side of the panel instead of stacking it as its own band underneath |
| Image tile → Image fit | How the image fills its box: Auto (cover) (the default — fills the box, cropping overflow) or Fill (crop to fit) / Fit inside (no crop) (shrinks to fit inside the box with no cropping, may show empty space on the sides) Image fit does not apply to a flush tile that has a caption overlay: that tile always fills with the photo (cover), whatever you choose here. |
| Image tile → Image shape | Locks the tile's shape: Auto (no fixed ratio — sizes to its container), Square, Portrait, Landscape, or Wide. Leave on Auto unless a specific column layout needs a fixed shape to line up neatly with its neighbours |
| Image tile → Focal point (X/Y) | Two percentage fields (0-100) controlling which part of the image stays visible when Image fit crops it — X is left-to-right, Y is top-to-bottom; 50 / 50 is dead centre. Both fields have to be filled in together — filling in only one is treated as unset and neither is saved, since a focal point needs both coordinates to mean anything |
| Add utility strip | Adds a band — a short row of links pinned to the leading or trailing edge of the panel (placement: Lead/Trail) — for a "Contact sales · Download app" style trailing row separate from the main columns |
The drawer's footer has Cancel, Save panel, and — once a panel exists for this link — a Remove disclosure panel button. If you try to close the drawer (via the backdrop, Escape, or Cancel) with unsaved edits, it shows a confirm prompt — "Discard unsaved changes? You have changes to this panel that haven't been saved. Closing now will lose them." — so an accidental dismiss doesn't silently drop your work.
Save panel blocks if a link column or band entry has a label but no URL
Every link (in a column or a utility-strip band) needs both a Label and a URL to be kept — a half-filled entry no longer disappears quietly. If one has a label and a blank URL, the URL field shows an inline error, and clicking Save panel shows an "Add a URL before saving" dialog naming the offending entry and blocks the save. Fill in the URL or delete the entry (its own delete control is always available), then save again.
Upgrade from mega panel, and Make dropdown on a link that has a legacy mega panel
If the link already has a legacy mega panel configured, the disclosure-panel dialog shows an Upgrade from mega panel button. Choosing Make dropdown from the link's More actions menu on a link that has a legacy mega panel (and no disclosure panel yet) runs the same conversion. It copies the panel's heading, links, descriptions, and badges into disclosure-panel columns and keeps:
- Category bindings. A column built from a linked category stays bound to that category, and the storefront fills in its links from the category. You no longer need to retype them.
- Featured products. The panel's featured products setting (category, number of products) comes across.
- Promo tile details. The tile's image, heading, subheading, call-to-action text, and image description, plus the category image. A tile set to show at the start or end of the panel keeps that side.
Your original mega panel is left untouched, so if you decide you don't like the result you haven't lost anything. If a disclosure panel already exists for the link, Make dropdown reuses it and does not convert again.
Featured products in a header block
A Featured products block shows product cards from one category inside the header. It is available on the header only: never in the footer, and not on every header row.
Add the block
Open a row that offers it
Go to Online Store → Theme → Page Layouts → Header and select the Header Navbar row in the structure tree (or the masthead row, on a template that has one). The Announcement Bar, Utility Bar, and Secondary Navigation (ribbon) rows do not offer this block.
Add block → Featured products
Under the Content tab select Add block. In the Add block dialog, Featured products is listed under Commerce, described as "Product cards from one category, shown inside a dropdown panel."
Pick a Category
Open the new block and use Category to choose a category. Helper text under it reads "Products from this category are shown. Collections are categories on this platform." The picker lists categories only; there is no separate collection picker.
Set Number of products and Heading (optional)
Number of products is a drop-down from 1 to 12 and defaults to 4. Heading (optional) is a short title shown above the cards; leave it empty for cards with no heading.
Save and publish
Select Save Draft, then Publish the Header. Customers do not see the block until you publish.
| Control | What it does |
|---|---|
| Category | The category whose products are shown. A block saved earlier with a collection keeps its source and is edited through this same category picker |
| Number of products | 1 to 12. Defaults to 4 |
| Heading (optional) | A short title shown above the product cards |
On the storefront, customers see that category's products as cards with the product image, name, and price, each linking to the product page (a card with no image just omits it). The storefront fetches only the categories your header uses, and shows no more than Number of products cards.
Featured products in a mega-menu panel
A link's mega panel has its own Featured products setting. Open it from Online Store → Theme → Page Layouts → Header: on the Header Navbar row, use the link's More actions → Edit mega menu (or the Edit (link name) mega menu button under the list in the Navigation part). In the panel settings, Featured products is a category picker, the same one the block uses. The help text reads "Products from this category are shown in the panel." Choose a category and it is saved as a category; a panel saved earlier with a collection still loads and shows that entry by name, and is rewritten as a category the next time you pick. The panel does not expose Number of products or Heading (optional); those two are set only on the block above. The Featured products and Promo tile controls show only for a legacy mega panel; a link whose panel was authored as a dropdown or navigation panel does not show them there.
Edge cases
- Nothing renders until a category is chosen. A freshly added block shows nothing on the storefront until you pick a Category.
- Not on every row. The Add block dialog for the Announcement Bar, Utility Bar, and Secondary Navigation rows does not list Featured products.
- Not in the footer. The footer's block picker never offers it.
- Categories only. Neither the block nor the mega-panel setting has a collection picker; collections are categories on this platform, and an older saved collection is shown by name and saved as a category on your next pick.
- A mega or dropdown panel that already carries a featured products setting, including one converted with Make dropdown (see above), keeps it.
Why don't customers see my Featured products?
Check, in order:
- No category selected. Open the block and choose a Category. Without one the block renders nothing.
- The category has no products (or the category was deleted). The block shows nothing for an empty or missing category. Choose a category that has products.
- Not published yet. Changes stay in your draft until you select Save Draft and then Publish the Header.
- Wrong row. The block is only offered on Header Navbar (or masthead) rows, so a header that shows no Featured products option in Add block is on a row that does not support it.
Each link, inside a column, can also carry an icon and a trailing icon (picked from a fixed icon set — not free text) and a numeric count badge. Columns and their links can be reordered by drag handle.
How your image tile's caption renders
The tile's Heading (and Link, if set) render as a caption overlaid on the image itself, with a darkened scrim behind the text so it stays legible over a busy photo — this is the default. A handful of disclosure-panel/mega-menu styles instead place that same caption below the photo rather than overlaid on it; which one you get follows the panel's own visual style, it isn't a setting you choose per tile.
Uploading images — URL or asset key only, no picker yet
The Image URL field takes a direct URL or a bare storage key — there's no built-in media-library picker for this field today, so you'll need to already have the image hosted (or its asset key) before filling this in. If you're not sure where to get one, upload the image anywhere else in the admin panel that does have a picker (e.g. a product image) first, then copy its URL from there.
Why don't customers see my disclosure panel?
Two separate things have to be true: (1) you clicked Save panel inside the dialog, and then Save Draft/Published the Header editor — Save Draft alone keeps it in the editor only; (2) the panel needs at least one column with a link, or one band, to count as "configured" — an empty panel behaves like nothing was set up. On mobile, a disclosure panel opens by tapping the nav item in the slide-out menu rather than hovering, since there's no hover on a touchscreen.
Category strips: a row of square image tiles inside a disclosure panel
A separate block from the promo image tile above — a full-width row of several small square (or custom-shaped) image tiles side by side, for a "shop by category" strip inside a mega-style panel. Available in the same panel editor opened from Opens or the link row's More actions menu, below the columns/image-tile controls, as Category strips.
| Control | What it does |
|---|---|
| Add category strip | Adds one strip. A panel can hold more than one |
| Placement | Above the columns or Below the columns — where the strip sits relative to your link columns |
| Strip title (optional) | An optional heading shown above the strip |
| Gap between tiles (px) | Spacing between tiles in the row. Blank uses the default spacing |
| Tile height (px) | Fixed tile height. Blank sizes tiles by their shape ratio instead |
| Min tile width (px) | The narrowest a tile can shrink to before the row wraps. Blank defaults to 96px |
| Add tile | Adds one tile to the strip — Image URL, Label, and Link |
All three geometry fields (gap, height, min width) are blank by default, so an untouched strip renders with the same spacing it always has — filling them in is optional fine-tuning, not a required step.
Zone layout: reordering what sits at the start, centre, and end of the bar
Before arranging existing blocks, you can add a missing Search or CTA child to the Main bar of a converted older header. Select Header Navbar in the structure tree, select Add block, then choose Search or CTA button. The new child is placed in the End zone and selected immediately.
- Search → Content has Placeholder and Search in (Current design, Everything, Products, or Categories); Design has Presentation (Current design, Icon, Overlay, Inline field, or Expanded bar); Behaviour has Search suggestions.
- CTA → Content has Label and Link; Design has Style (Current design, Primary, Secondary, or Plain); Behaviour has separate Show CTA switches for desktop and mobile.
Use the child's remove/hide action if you added the wrong block. If Add block does not offer a type, that child already exists or is not legal for the selected header structure; edit the existing child instead of trying to create a duplicate.
The Header Navbar row also has its own Zone layout control, below the navigation content described above — a separate mechanism from the Arrangement picker described earlier in this guide. Where Arrangement swaps between whole pre-built layouts (Standard, Centered Split, Stacked, and so on), Zone layout lets you drag individual elements (brand/logo, navigation, and each action icon) between three tracks — Start, Centre, and End — and reorder them within a track, without changing which overall arrangement you're on.
- Drag an element's handle to move it within its track, or use its ⋮ Move to… menu to send it to a different track.
- The Centre track holds exactly one element at a time — dropping a second element there is refused with an inline message ("The centre track holds one element").
- Once you've moved anything from its default position, a Custom arrangement badge appears next to the Zone layout heading so you can tell at a glance that this header no longer matches its arrangement's stock layout.
- A separate Order within Actions control appears once the End track holds action items — it lets you set the relative order of the action kinds themselves (cart/wishlist/account, Sign Up, the CTA button group, Search, Log In, and anything else), independent of which track they're in.
Configure each action block separately
In Header Navbar → Design, expand Action blocks. Use the Desktop/Mobile switch at the top of the panel first: the list is device-specific. Cart, Account, Wishlist, and Language / currency appear as separate rows, including on converted headers whose saved structure predates the separate catalogue.
| Control | Effect |
|---|---|
| Show / Hide | Includes or removes only that action on the selected device |
| Up / Down | Changes that action's order within the action cluster |
| Display | Icon, Icon + label, or Label |
| Cart badge | Cart only: Count, Dot, or Hidden |
Language/currency begins as a label and stays hidden if the selected header does not currently enable its locale capability; select Show to opt it in, then choose its Display treatment. Use the row's reset action to restore its default visibility, display, and position. These controls change the header draft only; select Save Draft and Publish before expecting customers to see the new action set.
An action is configured but not visible to a customer
Confirm you edited the same Desktop or Mobile view the customer is using and that the action's row says Hide (meaning it is currently shown). Account may require a signed-in customer, Wishlist may depend on the store's wishlist capability, and Language / currency needs locale support. Also check the action-cluster More menu below: lower-priority actions can move there when the bar is crowded, while Cart, Account, and Wishlist remain separate blocks.
When your links don't fit: the "More" menu
There is no setting for this — every storefront header handles it for you. If the links you've added are wider than the space the header template gives the navbar, the navbar does not cut them off or hide them behind an invisible scrollbar. Instead:
- The links that fit stay on the bar, in your configured order.
- The remaining links move into a More dropdown at the end of the navbar.
- Clicking More (or focusing it and pressing
Enter/↓) opens a panel listing them, with their badges intact.Esccloses it and returns focus to the More button;↑/↓,HomeandEndmove between items.
This is re-evaluated live as the browser window changes width, so the same store shows more links on a wide monitor and fewer (with a longer More list) on a narrow laptop. No link is ever dropped — bar plus More is always your full list.
When your icons and buttons don't fit: the actions "More" menu
The header's action cluster — search, wishlist, cart, account, Log In / Sign Up, and the header CTA button, free-shipping note and divider from the Config tab — gets the same treatment, and again there is no setting for it. If the cluster is wider than the space the template gives it, the controls that don't fit move into their own More dropdown at the right end of the bar rather than wrapping onto a second line (which a fixed-height header bar has no room for) or running off the edge of the page.
Which controls stay on the bar is not simply "the first ones". They are dropped in this order, last to be dropped first:
| Kept longest | Control |
|---|---|
| 1 | Cart, account, wishlist — the shopping controls. These never leave the bar at all |
| 2 | Sign Up |
| 3 | The header CTA button group (CTA button + text note + divider — they move together) |
| 4 | Search |
| 5 | Log In |
| 6 | Anything else — utility and policy links, locale switchers |
So on a crowded bar your customers keep the cart icon and see a More chevron beside it; the
free-shipping note and the Log In link are what move inside. Clicking More (or focusing it
and pressing Enter / ↓) opens the panel; each control works there exactly as it does on the
bar, and Esc closes the panel and returns focus to the More button. Nothing is ever removed —
bar plus More is always your full cluster, and it is re-evaluated live as the window resizes.
Your cart, wishlist and account icons never go behind More
Row 1 of that table is a guarantee, not just a preference. However narrow the bar gets — a long navigation, a small laptop, every header template and layout variant — the shopping icons keep their place on the bar and everything else moves into More around them. If there still isn't room, it is your navigation links that give way into the navbar's own More menu, because a link behind a menu is one click away while a cart behind a menu is a checkout your customer has to go looking for.
You may therefore see a bar that shows only your cart/wishlist/account icons and a single More chevron. When the navigation and the action cluster overflow at the same width, the header does not show two More buttons side by side: the two lists merge into one More panel, with the hidden navigation links listed first and the hidden controls (search, Log In, the CTA group and so on) below them, each working exactly as it does on the bar. That merged panel is the intended, most-crowded state, not a fault. If only one of the two overflows, only that one's More appears, exactly as described above.
Most of my action cluster is behind More — why?
The cluster ran out of room, which usually means the header variant is sharing that side of the
bar with your navigation. Centered split and Nav centered put navigation links in the same
track as the icons, so a long navigation squeezes the cluster first. Three fixes: turn off header
icons you don't use (Config tab — wishlist and search are the usual candidates), shorten your
navigation Labels, or switch to the Standard variant, which gives the action cluster the
whole right-hand side of the bar.
Why are some of my links under More?
It means the navbar ran out of room, not that anything is misconfigured. Three things widen it
again: shorten link Labels (the single biggest factor), toggle Enabled off on links you
don't need in the top nav, or switch the header variant — Nav centered hands the navbar the
whole middle of the bar, and Centered split divides your links either side of the logo, both of
which fit more links than a left-aligned bar. Turning off header icons you don't use
(wishlist, search) in the Config tab frees space too.
Mobile is different
On phones the header switches to the slide-out menu described under Header editor: Mobile mode below, which lists every link vertically — so the More menu is a desktop/tablet behaviour only.
Also editable from the page editor's Main bar row
Menu links and their Dropdown/Mega panels are edited at Online Store → Theme → Page Layouts → Header → Header Navbar → Navigation. Changes update the draft canvas immediately; use Save panel for the panel composer, then select the top-bar Save action for the Header draft. If that action shows Retry, the failed save has not discarded your edits. Stores still on the legacy (classic, pre-template-picker) header keep their classic editor; after a premium template is published, its bridge card's Edit Header button opens this Header Navbar path instead.
Header appearance
This card belongs to the legacy header editor (the pre-template-picker classic header). In the current Store Editor, use the Header's Design and Behaviour lenses described in Finding Header and Footer controls by task.
| Setting | What it does |
|---|---|
| Background colour (initial) | The header's background before the customer scrolls — supports HEX, RGB/RGBA, or transparent |
| Text colour (initial) | Text/icon colour to match the initial background |
| Scroll effect | Toggle on to have the header switch to a different background and text colour once the customer scrolls past a threshold — useful for a transparent header over a hero image that needs to become solid and legible once the page scrolls |
| Scrolled background / text colour | The colours the header switches to once scroll effect triggers |
| Wishlist / cart / user-menu icons | Toggle each on or off independently |
For pinning the header to the top on scroll, see Sticky Behavior on the Theme Settings entry, above.
Colour fields disappear once you're on a premium template
Background colour, Text colour, Scroll effect, and the two scrolled-colour fields above only appear on this card while your store is still using the legacy (classic, pre-template-picker) header. The moment you publish any of the 11 premium header templates described earlier in this guide, this card stops showing them — premium headers get their colours from the Color Schemes panel on the Theme Settings entry instead. There's no banner explaining the switch; if a colour field you remember setting has quietly disappeared from this page, that's why.
Header editor: Mobile mode
Switch the mode control at the top of the Header editor to Mobile to edit your mobile navigation, slide-out menu, and mobile header bar. This replaces the entire form on the left with the same task groups as the Behaviour tab's Mobile group (Navigation, Mobile header, and Menus); the preview on the right switches to the mobile storefront.
Current labels and sub-headings
In the Store Editor's Header inspector, the Behaviour tab's Mobile group is split under three sub-headings — Navigation, Mobile header, and Menus — instead of one long list. Choice lists now show plain wording (for example Bottom tab bar, Centered logo, Logo only, Icon overlay, and Inline search bar) rather than the raw setting names, and the tables below use the current control labels. Only the wording changed: your saved choices are unaffected. If you are looking for a control by its older name, search the inspector for the current label listed here.
Navigation style
| Setting | What it does |
|---|---|
| Navigation style | Hamburger drawer, a bottom tab bar with labelled icons, or a drawer — pick the mobile nav pattern (the Bottom tab bar choice was previously labelled with its raw setting name) |
| Drawer opens from | Slide in from the left or right (shown when Navigation style is Hamburger or Drawer) |
| Bottom-navigation items | When Navigation style is Bottom tab bar: add, edit, and remove up to 5 items, each with an icon, label, path, and an enabled toggle |
Slide-out menu
| Setting | What it does |
|---|---|
| Show profile in menu, Show cart in menu, Show wishlist in menu, Show social links in menu | Toggle whether each appears in the mobile slide-out menu |
| Menu animation | Slide, fade, or none |
| Custom menu links | Off by default (the drawer inherits your desktop navbar links); switch on to define a separate set of links (label, path, enabled) just for mobile, up to 20 |
Mobile header bar
| Setting | What it does |
|---|---|
| Use compact header | A slimmer mobile header, giving product images more vertical space |
| Show search in header | Show or hide the search bar in the mobile header |
| Keep header visible | Pin the header at the top on scroll, or let it scroll away |
| Header layout | Standard, Minimal, or Centered logo |
| Show cart in header, Show wishlist in header, Show account menu in header | Each icon defaults to inherit — it follows the matching desktop navbar toggle (shown as an "Inherit on/off" chip). Press Override to set a mobile-only value, or Reset to go back to inheriting |
Mobile Menu (Layout Axes)
Seven sizing/style controls for the mobile slide-out/dropdown menu panel itself, on the header's Config → Layout → Layout Axes list:
| Control | Values | Effect |
|---|---|---|
| Mobile Menu Height | Default / Dropdown / Full | Default (the leftmost button, keeping the template's own panel height) is the default. Dropdown caps the panel under the header bar; Full expands it to fill the screen |
| Mobile Menu — Width (px) | Blank (default), 200–640 | Blank spans the screen edge-to-edge (never exceeding 88% of the viewport width even when set). A value sets a fixed drawer width |
| Mobile Menu — Background Color | Blank (default) | A colour swatch you click to open a picker, plus a hex text field beside it — set either and the other updates to match. Blank keeps this template's own panel background |
| Mobile Menu — Text Color | Blank (default) | Same swatch-plus-hex control as Background Color, for the menu's link text. Blank keeps this template's own text colour. Applies on every header template except Masthead and Minimal Hamburger Bar, whose drawers keep their own built-in link colour (see the note below) |
| Mobile Menu — Link Size (px) | Blank (default), 10–48 | Blank keeps the template's own link text size |
| Mobile Menu — Space Between Links (px) | Blank (default), 0–64 | Blank keeps the template's own spacing between menu links |
| Mobile Menu — Badge Shape | Default (rounded pill) / Pill / Square / Outline | Default is the leftmost button and the default value. Shape of cart/wishlist count badges shown inside the mobile menu |
Not available on Masthead or Minimal Hamburger Bar
These seven controls don't appear on the Masthead or Minimal Hamburger Bar templates — both already render a full-height mobile menu with no second height to switch to, so the control would have nothing to do. Every other header template shows them in its Layout Axes list.
Blank means unchanged
Every one of these seven fields defaults to blank (or, on Mobile Menu Height and Badge Shape, the button labelled Default), and a blank/Default value renders your mobile menu exactly as it did before this control existed — set a value only once you want to override the template's own look.
Footer
Open Footer from the Page Layouts journey rail, or click Browse Templates from inside the classic Footer editor to jump straight to Online Store → Theme → Page Layouts → Footer (same sidebar-plus-gallery shell described under The structure sidebar and the template gallery above — a structure switcher at the top of the sidebar, a Templates › link that opens a look-only drawer, and a Theme Settings entry for the old Config-tab controls).
Using the newer Store Editor instead? Its footer has a different layout (Footer Sections list, Change template, arrangements, composing with blocks); the step-by-step guide is The Footer Editor.
All 7 footer templates require a paid plan
Just like the header, every one of the footer's 7 premium structures is a flagship design — on the Free plan each option in the structure switcher's menu shows a lock icon, and clicking one does nothing. Any paid plan (Starter, Growth, Pro, or Max) unlocks all 7; upgrade from Billing → Plans & Billing (see Plans & Billing). If a structure still shows locked right after upgrading, reload the Admin Panel so the switcher re-checks your plan.
Footer Looks: picking a look now sets its own type voice, not just colour
Click Templates › to open the same look-only drawer described under Changing look above — one Templates section of look cards for your currently-active footer structure. Clicking a card stages it into your preview the same way it does for the header.
For the footer specifically, a look now carries its own art direction, not just colour: picking a look card can set its own heading weight, heading capitalisation, heading letter spacing, link weight, and text scale (the same five typography controls under Footer Type above), so two looks on the same footer structure can read in genuinely different typographic voices — a tight, uppercase, tracked-out small-type look next to a looser, larger, sentence-case one — not only different colours.
Why did my footer's headings change font after I picked a look?
A look's art direction writes directly into the same Footer Type axis fields described above — Column Heading Weight, Capitalisation, Letter Spacing, and so on. If you'd rather keep your own typography after picking a look, clear those fields individually or click Reset axes above the Layout Axes list to blank all of them back to this design's own defaults; picking a different look afterwards will set its own values again.
Some Looks also seed a ready-made image-led footer band
A subset of the footer Looks — Marble Base, Golden Era, Cloud Soft, Terra Cotta, Desert Wind, Steampunk Core, Mystic Rune, and Velvet End, as of this wave — additionally seed a ready-made footer band the moment you pick that card: real packaged product/lifestyle photography arranged as a Media tiles block, alongside the rest of the template's default bands, so your storefront preview shows a finished image-led footer immediately instead of an empty shell. There's no separate toggle for this — it fires automatically as part of picking one of these Looks, at the same moment its type-axis art direction applies. You can freely edit or delete the seeded band like any other: open it from the Footer Section list (Online Store → Theme → Page Layouts → Footer, structure sidebar) — its Compose this Footer Section with blocks switch (see Composing a Footer Section with blocks below) is already on. Picking a different Look on the same footer replaces the seeded band's content with that Look's own seed (or removes it, for a Look that doesn't seed one); a band you've since hand-edited yourself is left alone and never silently overwritten by a later Look pick. Not every footer Look seeds a band — most still only change colour and type voice, exactly as before.
Reset axes also clears a Look-seeded band
Clicking Reset axes above the Layout Axes list on a footer whose current seeded band still matches the Look that created it also removes that seeded band, since the band's imagery and copy exist specifically to match the axes being reset. It never touches bands you've since edited by hand, or bands you added yourself.
Footer arrangements: 5 options
Like the header, arrangement is a separate control from structure and look — it doesn't live in the template gallery drawer. Open the Theme Settings entry in the sidebar, switch to its Design tab, and jump to the Variant section for 5 options that rearrange the same footer content without changing what it contains:
| Arrangement | Layout |
|---|---|
| Standard | The template's own native layout, unchanged — this is the default for every store |
| Columns | Link groups laid out as balanced columns, brand leading |
| Centered Stack | Everything centre-aligned, stacked vertically |
| Single Row | One horizontal row: brand, links, and social icons together |
| Split | Two-up layout — brand/newsletter on one side, links on the other |
Standard is still the default everywhere
Nothing switches you onto one of the other 4 arrangements automatically — every store that hasn't opened the gallery and staged a different arrangement keeps rendering Standard, the exact monolithic footer layout that shipped before this arrangement axis existed. Picking a different arrangement only rearranges where your existing columns, brand block, and social icons sit; it never adds or removes footer content.
Spacing Rhythm also scales the footer's band padding — only when Band Vertical Padding is left blank
Just like the header (see the Spacing Rhythm callout under Sticky Behavior above), the footer's own Spacing Rhythm control — Theme Settings → Layout → Spacing Rhythm, Compact/Standard/Generous, same naming as the page-wide Theme Customization Spacing Rhythm but scoped to the footer itself — scales every footer band's top-and-bottom padding: Compact = 0.5×, Standard = 1× (no change), Generous = 1.5× the template's own reference padding.
An explicit Band Vertical Padding wins. If you've set the Band Vertical Padding number under Layout Axes to a specific value, that value renders exactly as set — Spacing Rhythm's scaling only applies when Band Vertical Padding is left blank. Set both and change Spacing Rhythm, and you'll see no visible change; clear Band Vertical Padding back to blank to let Spacing Rhythm drive it again.
Layout and content
| Field | What it does |
|---|---|
| Background colour / text colour | Footer's own colour scheme, independent of your header |
| Columns | Organise footer links into columns, each with its own heading |
| About text | A short description shown in the footer |
| Copyright text | Leave this blank and the published store shows © [current year] [your store name]. All rights reserved. The admin preview shows no copyright line while the field is empty. Enter text and the published store shows it exactly as typed. It does not replace tokens such as {year} or {companyName}; the admin preview replaces {year} only. |
Colour fields disappear once you're on a premium footer template
Background colour and Text colour above only appear while your store is still using the legacy (classic, pre-template-picker) footer. Once you publish any of the 7 premium footer templates, they stop showing here — premium footers get their colours from the Color Schemes panel on the Theme Settings entry instead (see Color Schemes and Type Pairing above).
Also editable from the page editor's band rows
Columns, About text, and Copyright text above are also editable at Online Store → Theme → Page Layouts → Footer, in the structure sidebar's band rows — the same fields, same saved data, saved automatically as you type (no Save button). They're split across three different rows rather than one: the Link Columns row holds the Link toggles and Column Body Text described below; the Brand Statement row holds About text on its own; and the Legal Strip row holds Copyright text (alongside Legal Links, the language selector, and payment methods — see further down this page). If your store has already published one of the 7 premium footer templates, this classic page replaces Columns/About text/Copyright and the Link toggles/Column Body Text sections below with a single "Footer content has moved into the page editor" card. Its Edit Footer button lands you on the Link Columns row, and its own text says so — "Edit which footer links show and their column body text in the page editor... About text is there too, under Brand Statement" — so if you're looking for About text, follow that pointer to the Brand Statement row; Copyright isn't mentioned on this particular card because it lives under the second, separate bridge described under Legal Links below. Stores still on the legacy footer keep the full set of fields here, unchanged.
Managing footer bands: reorder, duplicate, change type, remove
At the top of the Footer Section list (Online Store → Theme → Page Layouts → Footer, structure sidebar) sits a + button that opens the Add Footer Section menu. It's disabled, with a short caption underneath it — "All sections this template supports are added — delete one to add another." — once you've added every band type your current footer template supports. If your template supports none at all (a small number of templates have no addable bands), the caption instead reads that the template "doesn't support additional sections" and tells you to switch structure to add one. Hovering the disabled button also shows the same reason as a tooltip, and if you reopen the menu before it's fully exhausted, each already-used or unsupported type in the list shows its own reason ("Already added" / "Not supported by this template's layout") directly under its label, not only on hover.
Each row in the Footer Section list carries its own row controls, to the left and right of the row's name:
| Control | What it does |
|---|---|
| Drag handle (leftmost) | Press and drag to reorder the band relative to the others — the same drag-to-reorder gesture used elsewhere in the editor (for example the header's block lists) |
| Up / down arrows | Move the band one position up or down — an alternative to dragging, for precise single-step reordering or keyboard use. Disabled at the top/bottom of the list |
| Duplicate (copy icon) | Inserts a new band directly below the original, with the same settings, so you can build a variant without starting from scratch |
| Change type (swap icon) | Opens a menu to convert the band to a different band type (Link Columns, Brand Statement, Newsletter, Social, Legal Strip, Category Links). The band's position and any editable content it holds carry over where possible; type-specific settings reset to that type's defaults. The menu greys out the band's own current type (nothing to change to) and any type already used elsewhere in your Footer Section list — each band type can only appear once |
| Remove (trash icon) | Deletes the band. Removing the last remaining band returns the footer to the template's default layout, the same as if you'd never added a band |
All of these save automatically, the same as any other band-row edit — there's no separate Save button for reordering, duplicating, or changing a band's type.
Link groups: custom columns inside the Link Columns band
Selecting the Link Columns band shows its column-body fields (Link toggles and Column Body Text — see Link toggles and Column Body Text further down this page) and, below them, a separate Link groups editor for building your own custom columns of links or text, in place of that band's default columns.
| Control | Effect |
|---|---|
| Add group | Adds a new group (column). New groups start with a real default title and no items. |
| Group icon (optional) | A small icon shown beside the group's title — one of 10 fixed choices (location, phone, mail, clock, shield, truck, card, gift, star, globe), or No icon |
| Group name | The column's heading text |
| Group drag handle | Reorders this group relative to the others |
| Group show/hide (eye icon) | Toggles whether this whole group renders on the storefront. Hidden groups stay in the editor — dimmed to half-opacity so you can tell at a glance — and keep every item inside them; toggling back on restores them exactly as left |
| Group delete (trash icon) | Removes the group and all its items |
| Add item | Opens a small menu to add either a Link or a Text block row inside the group |
Each item inside a group has its own controls:
| Control | Effect |
|---|---|
| Label + URL (Link items) | The link text and destination — pick one of your store's pages from the dropdown, or choose Custom URL to type any address |
| Text value (Text items) | A free-form multi-line text field, for a Text item — no link behaviour |
| Item drag handle | Reorders this item within its group |
| Item show/hide (eye icon) | Toggles whether this one item renders on the storefront, independent of its group and its siblings. Hidden items also dim to half-opacity in the editor |
| Item delete (trash icon) | Removes the item |
A Link groups column with no groups saves nothing
If you never open this editor (or remove every group you add), your footer simply keeps using that band's default column content — no empty "Link groups" data is saved at all, so there's nothing to clean up if you decide not to use it.
Call to Action band
Call to Action is a footer band type — add it from the same + Add Footer Section menu (or Change type menu) described above. It shows a headline, subtext, and up to two buttons (or an email signup field instead of a button), and renders nothing at all until at least one of its fields is set.
Screen: Online Store → Theme → Page Layouts → Footer, structure sidebar → select (or add) the Call to Action band:
| Field | Effect |
|---|---|
| Headline | The band's main heading text |
| Subtext | Supporting text shown under the headline |
| Button label | The first button's text |
| Button URL | Pick one of your store's pages, or choose Custom URL to type any address |
| Open in (button 1) | Same tab (default) or New tab |
| Second button label (optional) | The second button's text |
| Second button URL (optional) | Same page-picker/Custom URL choice as the first button |
| Open in (button 2) | Same tab (default) or New tab, independent of button 1 |
| Email signup instead | A switch that replaces the button with an email capture field |
Both buttons have their own show conditions
The first button only renders once both its label and its URL are set. The second button follows the same rule — label and URL both required — and only ever appears alongside the first button, never on its own: a Call to Action band with only a second-button label and URL filled in (and no first button) shows neither button. Email signup instead only shows once no button label + URL pair is fully set for button 1 — fill in a first button and the email field drops away automatically.
Category Links: a multi-column link band for the footer (FE-04.2)
Category Links is an eighth band type, available on all 7 premium footer templates from the same + Add Footer Section menu (or Change type menu) described above.
Screen: Online Store → Theme → Page Layouts → Footer, structure sidebar → + Add Footer Section → Category Links. This opens the band's own settings panel:
| Control | Values | Effect |
|---|---|---|
| Columns | Auto (default) / 1 / 2 / 3 / 4 | How many columns the groups below are laid out into. Auto picks a column count from how many groups you've added |
| Add group | button | Adds a new column group to the band |
Each group has:
| Control | Effect |
|---|---|
| Heading (optional) | A column title shown above the group's items. Leave blank for an unlabelled column |
| Drag handle | Reorders this group relative to the others |
| Delete icon | Removes the group |
| Add item | Adds a new link/text row inside this group |
Each item inside a group has a Link/Text kind selector: Link items get a Label and a URL field; Text items get a single free-form Text value field with no link behaviour. Every item also has a drag handle (reorder within its group) and a delete icon.
Empty bands and groups render nothing
A Category Links band with no groups, or a group with no items, doesn't show a placeholder — it renders as empty space. Add at least one group with at least one item before expecting to see anything on the storefront.
Per-band task groups
Selecting a band opens its settings panel; below its content fields (if any — some band types have none), the style controls are split by merchant task. Spacing & sizing holds padding and gaps, Shape & borders holds corner radius, and Colors holds the band background. All are optional and independent per band:
| Control | What it does |
|---|---|
| Vertical padding (px) | Space above and below the band's content |
| Horizontal padding (px) | Space to the left and right of the band's content |
| Gap between items (px) | Shown only for band types that lay out multiple items side by side (Link Columns and the Social band's split layout) — space between those items |
| Corner radius | A stepped choice (Square, Tight, Standard, Rounded, Pill) for the band's own corner rounding, independent of your template's overall corner radius setting |
| Background colour | A solid colour behind just this band, layered above the Footer bands colour scheme's background (see Color Schemes and Type Pairing above) and below any Ground image set there |
Clearing a field (deleting the number, or picking Default on Corner radius) removes that override entirely — the band falls back to the surrounding Footer bands scheme, exactly as if you'd never touched it. The canvas updates as you edit; select the top-bar Save action to persist the Footer draft.
Composing a Footer Section with blocks
Every footer band can also be built from smaller content blocks — image tiles, promo cards, logo rows, and more — the same block-composition idiom used for header rows (see Adding blocks to a header row above), applied to one band at a time instead of a zoned row. Select a band (Online Store → Theme → Page Layouts → Footer, structure sidebar) to open its settings panel; use the Components group for composition controls:
| Control | What it does |
|---|---|
| Compose this Footer Section with blocks | Off by default. Turning it on reveals a block list below, where you add and arrange your own content, alongside or instead of the band's default content. Turning it back off does not delete any blocks you've already added — they're kept, just hidden until you switch composing back on |
| Keep the built-in content | Only visible while composing is on; on by default. On, your blocks render alongside the band's normal built-in content. Off, the band's built-in content stops appearing and only your blocks render |
| Blocks list | Drag to reorder, click a block to open its settings, or the trash icon to remove it. Add opens a typed picker grouped by purpose (Media, Text, Commerce, Links, Utility) |
Composing doesn't clear your blocks when you turn it off
Unlike some other block-composition surfaces in this editor, the footer band composer keeps your block list exactly as it is when you switch Compose this Footer Section with blocks off — turning it back on later restores the same blocks, not an empty list.
Block types offered on a footer band. Clicking Add shows only the block types this platform's renderer actually draws for a footer band — no type is ever shown disabled or "coming soon." As of this wave that list includes, alongside the existing link/utility/commerce block types also used on header rows:
| Block type | What it's for | Key settings |
|---|---|---|
| Media tiles | A grid of images, each optionally linked | Columns, and per-image Image, Alt text, Link, and Caption |
| Promo card | A titled card with an optional image and call-to-action | Title, Body, Button label, Button link, Image + Image alt text, Image position (Left/Right/Top), Background (Surface/Accent/Inverse), Alignment (Start/Center) |
| Logo strip | A row of partner, trust, or app-store badges | Height (px), Gap (px), Alignment (Default/Start/Center/End), a "Monochrome at rest" checkbox, plus a per-badge list of Image, Alt text (required whenever that badge has a Link), Link, and Kind (Unspecified/Partner logo/Trust badge/App badge) |
| Editorial statement | A large pull-quote or statement, sized for a footer band | Eyebrow, Statement, Attribution, Size (Headline/Display), Alignment (Start/Center), Max width in characters |
| Stats row | A row of credibility numbers, such as orders shipped or years trading | Columns (Auto/2–5), Value size (Large/Extra large), a "Show dividers between stats" checkbox, plus a per-stat list of Value, Label, and Note |
| Locations | A grid of store locations with address and phone | Eyebrow, Source (Manual, or Pickup locations — shown with a "not live yet, still authored manually" hint), Columns (1–2), and Index style (None / Numeric — 1, 2, 3 / Padded — 01, 02, 03 / Circled) |
| Link column | A titled column of links | Title, Layout (Auto / Simple list / Icon + description rows / Numbered / Inline strip / Giant links (headline scale) — entries render at headline scale, one per row, reading the footer's own Column Heading Capitalisation/Letter Spacing axes above), Columns, Column balance, Divider between entries, and a Number style option (when Layout is Numbered) |
| Button | A single call-to-action button, grouped under "Commerce" in the Add picker | Button text, Link, and Style (Solid, Outlined, or Text only) |
Tile row is not offered on the footer, or anywhere else, yet
A "Tile row" block type exists in the platform's design vocabulary but has no settings panel built for it yet, so it's deliberately left out of every Add-block picker on every surface, footer included — you won't see it as an option to add.
Changes save with the page
Blocks you add or edit here don't have a separate Save button — they appear in the live preview beside you as you work and save automatically with the rest of the page, the same as every other band-row edit on this page.
Styling one band, group, or link: the Style tab
This section describes the older footer editor's Config and Style views
The Config and Style chips and the Type, Colour, Spacing, Background, This selection and Show and hide chips below belong to the older footer picker. The Theme → Page Layouts → Footer screen in the current admin panel has no Config or Style chips. In the Store Editor, a footer row's panel has four tabs: Style (colours, shadow, divider), Layout (content width, padding), Content and Behaviour (hide on desktop or mobile). A band's own Style panel there groups its controls under Layout (Max content width, Alignment), Typography (Typeface, Size, Weight, Capitalisation, Letter spacing) and Shape & borders (Corner shape). Use those names when following the steps below.
Everything above this point — Color Schemes, Footer Type, and the band composer's own blocks — lives behind a Config view of the Footer editor's sidebar settings panel. A second view, Style, sits next to it and is where you go to style a specific band, link column, or single link, instead of the whole footer at once.
Screen: Online Store → Theme → Page Layouts → Footer. Above the settings panel on the right of the structure sidebar, two chips read Config and Style — click Style to switch. The Style panel shows its own row of section chips: Type, Colour, Spacing, Background, This selection, and Show and hide.
Config and Style write the same footer, just at different scopes
Switching to Style doesn't open a separate settings surface — it's the same footer, the same autosave. Config holds the page-wide controls documented above (Color Schemes, Footer Type axes, band composer). Style's Type/Colour/Spacing/Background chips edit those same page-wide fields through a role-based, merchant-friendly layout instead of a raw axis list; its This selection chip is the one genuinely new capability — styling a single band, column, or link without touching anything else.
Type. A Footer Typeface select at the very top of the panel (blank/"this page's own typeface" by default, or any pairing from the same catalog as the page-wide Type Pairing control) — swaps this footer's own heading and body typefaces, independent of the rest of the page. Below it, an Overall text size control (a percentage, applies to the whole footer design), then a Wordmark / Headings / Links / Body text switcher. Headings reveals Weight, Capitalisation, and Letter spacing; Links reveals Weight only. Picking Wordmark or Body text shows a note instead of controls — those two roles don't have a page-wide axis, only a per-selection one; use This selection below once you've picked something in the tree.
Footer Typeface vs. a band/group/item's own Typeface override — the band wins
This Footer Typeface select is the same footerTypePairingId field as the Footer Typeface
entry in the Footer Type Layout Axes list
above — set it in either place and it updates the other, since they're two surfaces on one field.
It's the footer's own design-wide default typeface, applied to every heading in the footer. If
you've also set a Typeface on a specific band, group, or link via Style → This selection,
that per-selection Typeface always wins over this page-wide one for that specific piece — so a
footer-wide Footer Typeface pick can look like it "didn't take" on one band when really a more
specific override is quietly beating it. Check that band's own This selection → Typography →
Typeface field and clear it if you want the page-wide Footer Typeface to show through there too.
Colour. Five override swatches — Background, Text, Muted text, Hairlines and borders, Accent — plus the same Scheme (Default / Surface / Inverse / Brand / Transparent) and Emphasis (Standard / Subtle / Strong) dropdowns from Color Schemes → Footer above. A note under the swatches points out that Headings, Links, and Link hover colours aren't page-wide fields — set those per band, group, or link via This selection.
Spacing. Space above and below, Gap between footer blocks, and Content width (max width in px) for the whole footer design; a Newsletter box padding field appears too, only once your footer has a Newsletter band. "Gap between footer blocks" sets the space between the footer's top-level blocks (brand column, link columns, newsletter panel — or stacked rows, depending on your template's arrangement) — it does not change the spacing between individual links inside one column; that's the Gap between items (px) field under a band's own Spacing & sizing settings instead. Left/right space for one band specifically is, again, a This selection field.
Background. A Background image URL field; once a URL is set, a Focal point (X/Y sliders)
and a Darkening over the image slider (0–100%, defaults to 45%) appear. Below that, a
Gradient wash row of curated colour-swatch buttons — clicking one applies it and clears the
background image URL, since a photo and a mesh preset are mutually exclusive (typing a URL clears
the mesh selection back). This is the same bgImage/mesh state as the Ground image and
Gradient-mesh ground fields under Color Schemes above — the difference is presentation: this
tab's version is a compact URL box with no upload picker, while Theme Settings → Color Schemes'
version (documented above) additionally offers Image focus (a 9-position focal grid) and
Image overlay (Darkness / Overlay colour / a flat–top–bottom Direction toggle) plus a proper
upload/media-library picker via the same control every other image field in this editor uses — use
that one if you need to upload a file rather than paste a URL. On the Boxed Card Newsletter
template only, an italic note under Gradient wash points you to the band-scoped Ground
composition control described above, since this tab doesn't carry a page-wide equivalent for it.
This selection — styling one band, column, or link. Pick a row in the structure sidebar first — a band, a link column (group, shown when you expand a band that has columns), or a single link or text row inside a column (item) — then open the Style tab's This selection chip. What you see depends on what you picked:
| Field group | Band | Group (link column) | Item (one link/text row) |
|---|---|---|---|
| Typography | Typeface, Size (px), Weight, Capitalisation, Letter spacing | Same 5 fields | Same 5 fields |
| Colour | Background, Text, Headings, Links, Link hover, Muted text, Hairlines/borders, Accent (8 swatches) | Same 8 swatches | Text, Links, Link hover only (3 swatches) |
| Spacing | Space above/below, Space left/right, Gap between items | Space above/below, Space left/right, Space above/below (margin), Space left/right (margin), Gap between items | Space above/below (margin) only |
| Alignment / Content width | Both shown | Both shown | Neither shown |
| Shape | Corner shape, Float as an inset card | Not shown | Not shown |
Typeface is a Google Fonts field — type a family name or pick from a short curated list (Inter, Fraunces, Playfair Display, Cormorant Garamond, DM Serif Display, Space Grotesk, Sora, Manrope, Libre Baskerville, Bitter, Work Sans, Outfit, Cabinet Grotesk, Instrument Serif); any Google Fonts family name works even if it isn't in that list. Leave any field in This selection blank and that piece keeps the design's own value — nothing here is required.
Shape — a band-only pair of controls, below Alignment / Content width
Select a band (not a group or item) in the structure sidebar and This selection shows a Shape block the other two selection levels don't get: a Corner shape select (blank/"This design's own corners" by default, or Square / Tight / Standard / Rounded / Pill — the same stepped scale as the Config side's per-band Corner radius) and a Float as an inset card switch (off by default) that makes the band render as an inset card floating on the surrounding surface rather than filling the full width. Both are independent of the page-wide Corner radius on Theme Settings → Layout and of the per-band Corner radius under Per-band task groups on the Config side — set a Shape value here to override just that one band's shape from the Style tab instead. Leave both blank/off and the band keeps rendering exactly as it did before this control existed.
Why did my band's shape change everywhere except this one band?
Shape lives only in This selection, band level — pick the exact band you want to change in the structure sidebar before opening Style → This selection, and check the "Styling: " label at the top of the panel confirms you have the right one selected. Setting Corner shape or Float as an inset card while a group or item is selected has no effect, since neither of those two levels shows this block at all.
Nothing selected? This selection shows an empty state
If you open the Style tab's This selection chip without first clicking a band, group, or item in the structure sidebar, it shows "Pick a band, group, block or link in the tree to style just that piece" instead of any fields — pick something in the tree first, then come back to this chip.
Show and hide. Two cards, shown only for the bands that exist on your footer:
- Legal strip band — a Show this band switch (turning it off asks you to confirm first, since hiding the band also takes down everything nested in it — see the confirm dialog below), plus four sub-switches: Copyright line, Legal links, Language selector, and Payment method icons.
- Newsletter band — a Show this band switch (no confirmation needed here), plus three sub-switches: Headline and description, Phone number field, and Consent checkbox.
If your footer has neither band, this chip shows a note to add a Legal Strip or Newsletter band from the Config side first.
Payment method icons needs two switches on, not one
The Style tab's Payment method icons sub-switch carries its own caption: "Also needs 'Show payment icons' enabled in Store Branding → Footer — both switches must be on." The two are genuinely AND-gated on the storefront — the customer portal's footer only shows payment badges when both this switch and the Store Branding → Footer → Show payment icons toggle (see Features below) are on. These switches are only the display gate; the method must also be currently accepted, as explained below. Turning on only one leaves the icons hidden; if a merchant reports missing payment icons, check both switches and the payment capability before assuming a bug.
Pick what you want to style
In the structure sidebar, click a band to select it. If it has link columns, click the chevron next to the band to expand it, then click a column (group) to select that, or the chevron next to the column to expand it further and click a single link/text row (item).
Open Style → This selection
Switch the Config/Style chip to Style, then click the This selection section chip. The panel shows a "Styling: " label confirming what you've selected, then the Typography/Colour/ Spacing (and, for bands/groups, Alignment/Content width) fields for that level.
Set only the fields you want to override
Every field here is optional and starts blank — set a Typeface, a colour, or a spacing value and only that piece changes; leave the rest blank and they keep inheriting the design's own values.
Check the result in the live preview
Changes autosave and reflect in the editor's live preview immediately, the same as every other field on this page.
Hiding a band directly from the tree, without opening Style
Each band row in the structure sidebar also has its own eye icon — click it to toggle that band's visibility without opening the Style tab's Show and hide chip at all. Hiding the Legal Strip band this way shows the exact same confirmation dialog described above, since it's the same underlying toggle either way.
Why didn't my font or colour change show up?
Two different scopes look similar and are easy to mix up. The Style tab's Type and Colour chips (and the page-wide Color Schemes/Footer Type controls under Config) set the design's own values for the whole footer — Wordmark and Body text roles specifically have no page-wide field at all. This selection only affects whichever band, column, or link you had selected in the tree at the moment you set it — if you meant to restyle the whole footer but only had one link selected, your change only touched that link. Re-check what's selected in the tree (the "Styling: " label confirms it) before assuming a field silently failed.
Link columns (Minimal Link template only)
The Minimal Link footer template has one control of its own in Theme Settings, alongside the shared Color Schemes and Type Pairing controls above: Link columns, a number field from 2 to 4 (default 3) that sets how many columns your footer's link groups are arranged into on desktop. It has no effect on any other footer template, and no effect on mobile, which always stacks columns regardless of this setting.
Why don't I see my footer tagline?
The About text field above is what shows as the short description/tagline under your logo in the footer — it's blank until you set it, so a store that hasn't filled it in simply shows no tagline (not an error). If you've never published a Footer design at all, the copyright line is generated automatically from your store name (for example, “© 2026 Sage & Still. All rights reserved.”) rather than using whatever is saved in the Copyright text field above — publish a Footer design to take control of the exact copyright wording.
Social band content
Select the Social row in the Footer Section list (Online Store → Theme → Page Layouts → Footer, sidebar tree) to open its own settings panel. As of 2026-09-03 the panel has two parts, stacked one above the other: Social Links (the platform list + Appearance controls, new) and Link style (which platforms/text combination this band shows, existing).
Social Links. The exact same ordered-list-plus-Appearance editor as Social Links (new) in Store
Branding → Socials
— add/reorder/hide/remove platforms (including custom ones), then style the icons' layout, shape,
border, size, gap, and alignment. It's the same underlying branding.socialLinksList /
branding.socialPresentation data either editor writes to — a change made here shows up on the
Store Branding → Socials tab too, and vice versa, since both are two mount points for one save.
| Field | What it does |
|---|---|
| Link style | How this footer's social links are shown: Icons only (just the platform icon, no text), Text labels only (just the platform name, no icon), or Icon + label (both together, side by side) |
Which platforms show up here — now editable from either place
Before 2026-09-03, this band's panel only controlled HOW your social links display, not WHICH ones — you had to go to the Socials tab in Store Branding to add or remove a platform. The new Social Links section above lets you manage the platform list directly from this band too. If no social platforms are connected (via either editor), the Link style choice below has nothing to display, whichever option you pick. See Which card wins if you fill in both? if you also still have the classic Social Handles fields filled in.
Unset behaves exactly like the classic footer's Social style toggle
If you never open the Link style control, the Social band falls back to whatever your footer's older, classic Social style setting already had — a store that set that to "List" shows text labels, everything else shows icons, exactly as before this control existed. Picking a value here overrides that fallback for this band going forward.
Contact details in the footer
The Theme Settings entry of the footer editor has three optional contact fields — Contact phone, Contact email, and Address. Fill in any one of them and a contact row appears in the footer, between the main footer content and the bottom legal bar:
| Field | What customers see |
|---|---|
| Contact phone | The number as a tap-to-call link — tapping it on a phone opens the dialler |
| Contact email | The address as a tap-to-email link — clicking it opens the customer's mail app |
| Address | Plain text, not a link (so it doesn't compete with the two links beside it) |
All three are blank by default and each is independent: set only the email and only the email shows, with no empty space where the other two would be. Leave all three blank and the footer renders exactly as it did before — no gap, no divider, nothing.
The contact row now renders on all 7 footer templates
All 7 footer templates render the contact row now — the last two, Divided Column Sidebar and Split Two-Tone Panel, picked it up most recently. If you've filled in a contact field and still can't see it on your storefront, the usual cause is a stale published bundle rather than a template gap: Publish the footer (Save Draft alone keeps it in the editor only), then hard-refresh.
This is separate from your Contact page
These fields only control the small contact row in the footer. Your full contact page — with a form, map, and business hours — is configured separately; see About & Contact pages.
Link toggles
Toggle individual footer links on or off: About, Contact, FAQ, Track Order, Privacy Policy, Terms, Refund Policy, and Shipping Policy.
Column Body Text
Optional supporting text shown under a footer link column's heading, on the templates that render column bodies — a short paragraph rather than another list of links, for a column like "Our Story." Each of your footer's link columns (matching the Link toggles above) gets its own body-text field here; leave one blank and that column renders as a plain link list, exactly as it did before this field existed.
Legal Links
Additional legal/compliance links shown in the footer's legal strip alongside your existing Privacy Policy / Terms links — for things like a Cookie Policy or an Accessibility statement. Add any number of label/URL pairs; this list renders as its own block only when it has at least one entry, so an empty list has no visible effect and doesn't add a stray gap or divider.
Also editable from the page editor's Legal Strip row
This list — plus Copyright text, the language selector, and payment methods below — is also editable at Online Store → Theme → Page Layouts → Footer, in the structure sidebar's Legal Strip row, autosaving the same way as the band rows described earlier on this page. If your store has already published a premium footer template, this classic page replaces the section above with its own "Legal links have moved into the page editor" card, whose Edit Footer button jumps straight to the Legal Strip row (unlike the Column-content bridge higher up this page, this one lands on the right row directly). Stores still on the legacy footer keep editing here as before.
Features
| Toggle | What it does |
|---|---|
| Show socials | Displays icons for whichever social links you set in Store Branding |
| Show payment icons | Displays the methods configured for the footer. COD remains available unless the store explicitly turns it off; card, UPI, netbanking, wallet, and other online labels remain after the public payment-status check confirms an active gateway. While that check is pending or unavailable, the footer keeps its previously configured badge row rather than making it disappear. |
| Newsletter sign-up | Adds an email sign-up field directly in the footer |
| Simplified mobile footer | Collapses the multi-column footer into a compact layout on small screens |
Social icons come from Store Branding
You don't re-enter your social links here — the footer's social icons pull from the same links you set in Online Store → Theme → Look & Feel → Logo & Identity. Each icon is the platform's real brand mark (Facebook, Instagram, X, YouTube, LinkedIn, TikTok); a platform this guide doesn't cover still gets a generic link icon rather than being skipped.
Why did the payment badges disappear from my footer?
First check both display controls: Online Store → Theme → Footer → Show payment icons and the page editor's Legal Strip → Style → This selection → Payment method icons must both be on. Then check the methods configured in the Legal Strip: a COD label is shown only when storewide COD is not explicitly turned off, including on an older store where that optional setting is missing. Online labels remain when the store has an active payment gateway. The gateway check is public, so guests see those labels too. While the check is still pending or cannot be completed, the footer preserves the configured badge row; an authoritative inactive result removes only the online labels.
To restore online badges, go to Plugins → Plugins → Razorpay, choose Install & Set Up if needed, open Setup, select Live, enter the Key ID and Key Secret, use Test credentials, and choose Save; saving also activates the plugin. To accept COD for a particular address, go to Settings → Delivery, add or edit its six-digit pincode rule, set Cash on delivery to Yes, and save. That pincode or delivery-zone rule controls checkout eligibility. If COD is absent from the footer itself, confirm COD is included in the Legal Strip's configured payment methods and that the store has not explicitly turned COD off.
This card is not part of the Legal Strip / page-editor bridge
Unlike the sections above it on this page, this Features card (and the Show payment icons / Newsletter sign-up fields inside it) is not replaced by a bridge card once you publish a premium template — it keeps rendering here the same as before. Show payment icons does share its on/off value with the payment-methods control on the page editor's Legal Strip row (same field, two mounts), so a change here shows up there too. The newsletter content fields below (placeholder text, button label, consent block) are similarly also editable on the page editor's Newsletter row — but the Newsletter sign-up on/off toggle itself, and Show socials, only exist on this classic page for now.
Newsletter sign-up is a real subscription
When a customer submits the footer's email field, they must also check a GDPR consent box before the button becomes clickable — this applies to every footer design, not just one look. Submitting saves them to your subscriber list — it isn't a decorative form. New subscribers, tagged with source Store, show up in Marketing → Newsletter alongside subscribers captured from your landing pages and hosted sites — see Forms & Newsletter for how to review, filter, and broadcast to your list.
Some footer designs don't show an email field at all. A handful of the more minimal footer looks are deliberately text-and-links only — toggling Newsletter sign-up on has no visible effect for those designs. If you've enabled the toggle and still don't see the email field on your live storefront, switch to a different footer structure using the switcher at the top of the sidebar and check again; most designs do include it.
Once Newsletter sign-up is on, three more fields appear:
| Field | What it does |
|---|---|
| Email input placeholder text | The hint text shown inside the email field on your storefront (not this admin field's own helper text) |
| Subscribe button label | The button's label; leave blank to use the default "Subscribe" |
| Phone input placeholder text | Adds a second, phone-number input to the newsletter form (in addition to email) on the templates that render it — leave blank and no phone field appears |
Second consent block (optional)
Below the newsletter fields, an optional second consent block lets you show a separate opt-in checkbox alongside the newsletter form — useful for a distinct marketing/SMS consent, on top of the regular GDPR consent every footer newsletter form already requires. It has its own Consent heading, Consent checkbox label, and an optional Privacy link text / Privacy link URL pair. Leave all of it blank and the newsletter form renders with just the one, regular consent checkbox — exactly as before.
Both the phone field and the second consent block render only on the same 5 footer templates that have their own newsletter form: Divided Column Sidebar, Boxed Card Newsletter, Split Two-Tone Panel, Inline Column Newsletter, and Panel Card. On Centered Minimal Luxury and Minimal Link (which don't render a newsletter form at all) these fields still save but have no visible effect.
Why don't I see new subscribers from my footer?
If a customer says they signed up but never appears in Marketing → Newsletter, the most common cause is that they left the GDPR consent box unticked and their submission never went through — the button stays disabled until it's checked, so nothing was ever sent. Ask them to try again and confirm they check the box before submitting.
All footer templates now show the same content
Every premium footer template (Template list above) renders the same set of content your classic footer settings define: your About text, the newsletter sign-up description (the line of copy above the email field, editable wherever your newsletter copy is set), the payment-method badges when Show payment icons is on and at least one configured method is currently accepted, and the language switcher (if you've enabled multiple storefront languages). If your footer previously looked like it was missing your tagline or payment badges after switching templates, that's fixed — every template now uses the same content and acceptance rules, just arranged in that template's own visual style. Stores on plans that include the BillionBiz platform badge also see a "Powered by BillionBiz" link in the footer automatically; it isn't a setting you toggle here.