40 min read

The Theme Hub: Browse, Apply & Fine-Tune

Browse theme packs, preview one against your current storefront, apply it store-wide, and fine-tune individual colour tokens.

A theme pack is a complete visual language for your store — colours, depth, borders, and typography feel, all defined together. Applying one changes your entire storefront at once; you don't set it page by page.

Screen: Store Editor → Settings → Theme. Open the editor from Online Store → Theme → Page Layouts → Customers browse → Product page. The Online Store group is called storefront in the new admin sidebar. The Theme hub has six tabs: Fine-tune, Custom, Identities, Store templates, Browse, and Featured. Store templates restyles your whole store at once and is covered in Store Templates.

Browse tab

The Browse tab shows every available theme pack as a grid of cards.

  • Search by theme name using the search box.
  • Filter using the chip filters — All, Light, Dark, Structural, Palette only — or by theme family (Surface/Depth, Anti-Aesthetic, Retro/Futurist, Atmospheric).
  • Click any card to open a preview on the right, rendering a mini-storefront in that theme. The same click also previews the theme on the editor canvas, so you can judge it against your real pages. This is only a preview: nothing is saved until you press Apply Theme. Leaving the Theme hub or cancelling the apply dialog puts the canvas back on your saved theme.

Curated picks — seasonal themes, trending looks, and editor's choices. Browse and apply them the same way as the Browse tab.

Custom tab

Any custom themes your store has saved — either created through the Fine-tune panel or by your brand team — appear here.

Viewing your live store and the live preview

Screen: Online Store → Theme.

The Theme page has two different things that look alike: the live preview (your storefront drawn inside the editor, so you can judge a change before saving) and the View store controls (which open your real, public storefront in a new browser tab).

Open your real storefront

  1. Open Online Store → Theme.
  2. Select View store. On the classic layout it is the outlined button in the page header; on the new (v2) layout it is the main button in the masthead at the top of the page.
  3. Your storefront opens in a new tab. Each Theme page also has a small open-in-new-tab icon in the preview's toolbar (tooltip Open in new tab) that does the same thing.

These controls open your store's real address, picked in this order: your active custom domain, then your store's BillionBiz address, then the Website URL saved under Online Store → Theme → Look & Feel → General. A custom domain only counts once its status is active.

When none of those addresses is set, the classic layout disables View store and the preview-toolbar icon (they look greyed out and do nothing). On the new layout the toolbar icon is disabled and View store shows the message Your storefront link isn't ready yet — it'll appear here soon. instead of opening a tab. The live preview picks its address by a separate rule (your store's BillionBiz address first), so the preview and the open button can occasionally disagree: the preview may render while the open button is disabled, or the preview may show your BillionBiz address while the button opens your custom domain.

How the live preview loads and resizes

  • The preview waits for your store to load. For the first moment after you open the Theme page, the preview pane stays blank while your store's settings load, then the preview appears. This is so the preview never requests the wrong site first.
  • On a phone-width screen the preview moves below the form. On the new layout at about 640 pixels wide or narrower, the settings form takes the full width and the preview stacks underneath it, full width and a fixed height, instead of sitting beside the form. Scroll down to see it. The open-in-new-tab icon in the preview toolbar stays reachable there. On wider screens the two sit side by side as before.

Troubleshooting: why is View store greyed out, or the preview says Preview unavailable?

Both mean your store has no address yet. On the new layout the preview pane then reads Preview unavailable with the text Your storefront address isn't set up yet, so there is nothing to preview. It will appear here once your store has a domain. Check Online Store → Domains for an address, or fill in the Website URL under Look & Feel → General, then reload. If you connected a custom domain but View store still opens your BillionBiz address, the custom domain is not active yet; it takes over once its status turns active.

Applied badge and Compare mode

The theme currently active on your store shows an Applied badge on its card. Hover over a different theme card to reveal a compare option, which opens a side-by-side preview of your current theme against the one you're considering.

Applying a theme

Preview the theme

Click a theme card to open its preview panel on the right.

Press Apply Theme

A confirmation dialog shows the theme name and its colour swatches.

Confirm

The dialog is titled Apply this theme?. Press Apply Theme again to confirm (or Cancel to keep your current theme). You see Theme applied to storefront and the editor canvas refreshes to the saved theme. The change takes effect on your live storefront immediately — there's no separate publish step for a theme change. If it fails you see Failed to apply theme and nothing changes.

My theme applied but the page still looks the same

Do a hard refresh in your browser (Shift + reload, or Ctrl+Shift+R / Cmd+Shift+R). BillionBiz stores use content-hashed bundles, so a hard refresh loads the new CSS.

Apply a theme from Look & Feel (v2 admin)

If your admin uses the v2 layout, Online Store → Theme → Look & Feel also has a Theme section in its section selector, with an Appearance card and a Theme library grid of curated themes plus Browse all 100+ themes.

Choose a theme

In Theme library, use a theme's apply button (the grid cards say Use this theme; the Browse all list works the same). A dialog titled Swap your storefront theme names the theme and asks whether to switch.

Preview before you decide

While the dialog is open, the live preview already shows the chosen theme. Select Cancel and the preview goes back to your current theme; nothing was changed.

Apply, then save

Select Apply theme. Applying sets the theme together with its brand colours (primary, secondary and accent), so the palette follows the theme instead of keeping your old brand colours. It is a draft change: use the panel's Save action to store it. After saving, the storefront uses the new theme and colours.

Check the Appearance card

The Appearance card shows the applied theme: Palette shows four swatches labelled with their hex codes (brand, accent, paper, ink) and Type pairing shows the theme's own display and body fonts. A store that has never applied a theme still shows the standard BillionBiz palette and type pairing.

The Appearance card still shows the old palette

It follows the theme you have applied, so it changes after you confirm Apply theme in the dialog, not while you are only previewing (and previewing then cancelling leaves it unchanged). If it still shows the old colours after saving, reload the admin panel.

Product listings and product pages follow the applied theme

After you explicitly apply a theme preset in the current Store Editor, your product listing and individual product pages inherit the preset's heading and body fonts, primary colours, and button corner radius. Their selected page layouts remain in place; the applied theme changes the shared visual treatment around those layouts.

Apply a preset

Go to Store Editor → Settings → Theme. Choose a preset from Browse or Featured, select Apply Theme, and confirm the action.

Fine-tune if needed

Open Fine-tune, adjust the colours, heading or body fonts, or radius preset, and select Save theme. Fine-tune changes are not persisted until that save completes.

Check both commerce pages

Open a product listing and an individual product page in a fresh storefront view. Confirm their fonts, primary-colour actions, and button corners follow the saved theme, then refresh once if an older view was already open.

Stores that have never explicitly applied a preset keep their existing product-listing and product-page styling. Browsing or previewing a theme alone does not opt those pages into a new visual treatment.

The product listing page follows the store theme unless you pick one for it

The product listing (Category) page has its own optional theme choice in the Store Editor. Opening the Category page in the Store Editor no longer saves a page theme on its own: unless you explicitly pick a theme or Look for that page, the page saves without one and shows the store-wide theme from Settings → Theme. In the editor's preview, an un-picked Category page is drawn with that store-wide theme too, so the preview matches the storefront.

  • Never picked: the listing page follows the store theme, and changing the store theme changes the listing page with it.
  • Picked once: choosing a theme or Look card for the Category page in the Store Editor's template gallery and applying it saves that theme on the page. It then stays put when the store theme changes. Applying the gallery with only a layout change does not count as picking a theme. A saved custom theme chosen under Your Custom Themes in the page's Theme section counts as picking a theme too, so the page keeps that custom theme instead of following the store theme.
  • Already had a saved theme: pages that carried a saved page theme before this change keep it. Picking a theme again for the page (even the same one) sets it explicitly.

Why doesn't my listing page change when I change the store theme?

The page most likely carries its own saved theme, from an earlier Store Editor save or because you picked a Look for it. That page theme wins over the store-wide theme. Open Store Editor → Pages → Browse → Product Listing and check which theme or Look the page uses. If the page has never had a theme picked, hard refresh the storefront (Ctrl+Shift+R / Cmd+Shift+R) and confirm the store theme change was saved with Save theme.

My product page still shows the old font

First return to Settings → Theme and confirm the preset is marked Applied. If you changed a font in Fine-tune, select Save theme before leaving. Then open the product page in a fresh tab or hard-refresh it; if the old font remains, confirm the heading or body font you expected was actually changed in the saved theme.

For page-specific Type pairing, Motion, spacing, and supported region or text-element overrides, see Style and motion in the current Store Editor. An explicit element font or colour can take priority over the shared page and theme fallback.

Store-wide Product cards style

Use one shared card treatment for the products customers browse in a listing and the products recommended on a product detail page. Keep a local override when one page needs a different look; otherwise let both surfaces follow the store style.

Where the shared style applies

This guide covers the cards on product listings and the recommendation, cross-sell, and bundle cards on product pages. Landing-page grids, wishlist, thank-you, and 404 recommendations are not connected; see the table below. Once saved, the style repaints each product card on your live storefront: the card surface, the title, price, and detail text, and the card's own buttons. A store with no card style set renders exactly as before, and anything you have already saved on a specific page still takes priority.

Set up a shared card treatment

Screen: Store Editor → Site-wide → Product cards. Open the editor from Online Store → Theme → Page Layouts → Customers browse → Product page or Category page, then choose the Site-wide tile and Product cards category. The panel heading is Site-wide settings. Use the current Store Editor; the classic page-layout picker does not provide this shared group.

Start with a representative listing and product

Choose a category with several products and a product page with populated recommendations or bundle suggestions. Include long titles, prices, product details, images, and available and unavailable actions so you can judge the treatment with real content. A card style does not create recommendations or turn on an action your template does not show.

Open the shared style group

Open Product cards at the setup path above. Begin with a small change, such as Corner radius and Padding. Leaving the style unset keeps the existing template rendering; you do not need to recreate all of its defaults.

Choose surface, text, and action settings

Use the appearance controls below for the card container. Set title and price typography separately, and style the primary and secondary actions that your cards actually render. Prefer a theme-linked colour when the style should track future theme changes; use a custom colour when it should remain fixed. Choose a Theme: option or Custom colour; Template default removes the forced colour.

Check both surfaces and save

The shared canvas opens a product listing so you can inspect card changes. Check the matching product-page recommendations too, including desktop and mobile. Store style changes autosave: wait for Saving… to become Saved before leaving. There is no separate store-style Save or Publish button. Local page changes still need their own publish action. Open fresh storefront pages and check both surfaces; a preview alone does not prove that customers see the saved style. On the storefront, product-list cards and product-page recommendation, cross-sell, and bundle cards pick up the saved style on the next page load. Product-list card buttons follow the Buttons and controls settings of this style; product-page cards show the surface, title, and price styling only.

Card appearance controls

Open Product cards → Card · Appearance. Each row can inherit independently. The style changes the card container; page layout and catalogue content remain separate.

ControlChoices and intended result
Surface styleNone, Outline, Filled, or Elevated: a plain surface, an outline, a filled surface, or a filled surface with elevation. Explicit colour and shadow settings can replace the corresponding preset parts.
Corner radiusNone, Sm, Md, Lg, or Xl changes the card container's rounding. It does not promise to change the image crop or rounding inside it.
PaddingNone, Sm, Md, or Lg sets space between the card's content and its edges.
MarginNone, Sm, Md, or Lg adds space above and below the card container; it does not change the page gutters.
Border widthNone, Thin, Medium, or Thick controls the card outline's thickness. A border colour needs a visible width to be seen.
Border colourA theme colour follows the theme; a custom colour fixes the outline colour.
Background colourSets the card container's background without changing the product image itself.
ShadowNone, Sm, Md, or Lg changes the card's elevation. Check contrast against the page background.
Inner gapSm, Md, or Lg sets spacing between supported children inside a card. It is separate from the page's grid columns and outer section spacing.
Text colourSets the card container's inherited text colour. An explicit title, price, or details Colour takes priority.

For example, combine Surface style → Filled, Padding → Md, and Corner radius → Lg for a filled card with breathing room. To return to a plain surface, reset any explicit Background colour and Shadow too; changing only the surface preset may leave a separate override in force. Border width and Border colour are hidden when Surface style is None; saved values are retained.

The shared panel is not tied to one selected page template, so its rows are editable without a page support matrix. Each consuming template still needs to render the relevant card element. A details line or secondary button that is absent cannot be created by changing its style.

Title, price, and details typography

Screen: Store Editor → Site-wide → Product cards → Card · Text → Title, Price, or Details. The third element is product metadata: styling it will not add a details line to a card that has none. Each element gets its own settings, so you can emphasize the price without changing the title.

Control for each elementChoices and intended result
Font role or familyBody or Heading follows the shared font role. System sans, System serif, Inter, Playfair display, or Dm sans picks a specific family for the element.
Size scaleXs, Sm, Base, Lg, Xl, 2xl, 3xl, or 4xl chooses a named text size. Larger sizes adapt to the viewport.
Weight300, 400, 500, 600, 700, or 800 changes emphasis; the chosen font also affects the result.
StyleNormal or Italic changes the text treatment.
Letter spacingTight, Normal, Wide, or Wider changes spacing between letters.
CaseNone, Uppercase, Lowercase, or Capitalize changes display case without rewriting your catalogue.
AlignmentStart, Center, End, or Justify aligns text within its element.
ColourSets this element's colour. Prefer a theme colour when it should follow the theme.

Start by setting Font role or family → Heading on the title and Font role or family → Body on details. Adjust the price's Weight separately. Check a long product name on mobile before increasing Size scale. An explicit family can keep an element different from the theme's shared font roles; reset that property when you want it to inherit again.

Primary and secondary card buttons

Screen: Store Editor → Site-wide → Product cards → Buttons and controls → Primary button · Style or Secondary button · Style. The roles style existing card actions. Which action uses each role depends on the template; styling a role does not add an add-to-cart or wishlist button where none is rendered.

Both roles use the same controls. The state colours let you distinguish an interactive action, a selected action, an unavailable action, and keyboard focus.

Control for each roleChoices and intended result
ShapeSquare, Rounded, or Pill sets the preset rounding.
Fill styleSolid, Outline, or Ghost sets the base treatment. Outline and Ghost keep the base background transparent.
SizeSm, Md, or Lg sets preset padding.
Full widthMakes the button fill its available container width.
FillSolid or Gradient chooses how the background is authored with the solid fill treatment.
Solid colourSets the colour when Fill is Solid.
Gradient angleWhen Fill is Gradient, sets the blend direction from 0 to 360 degrees.
Start colour; End colourSet the two ends of the gradient.
Text colourSets the button label colour in its normal state.
Border colourSets the normal-state outline colour.
Hover background colourChanges the background while a pointer hovers over an interactive button.
Hover text colourChanges the label colour on hover.
Hover border colourChanges the outline colour on hover.
Selected background colourChanges the background when the template marks the action selected.
Selected text colourChanges the selected label colour.
Selected border colourChanges the selected outline colour.
Disabled background colourChanges the unavailable button's background without making it actionable.
Disabled text colourChanges the unavailable label colour; keep it readable.
Disabled border colourChanges the unavailable outline colour.
Focus ring colourMakes keyboard focus recognizable against the surrounding surface.
Corner radiusA 0–999px override takes priority over the preset shape.
Border widthA 0–8px override sets outline thickness.
Horizontal paddingA 0–96px override sets left and right inner spacing, taking priority over the size preset.
Vertical paddingA 0–48px override sets top and bottom inner spacing, taking priority over the size preset.
Named styleA template-defined button variant. Leave unset unless the template provides a known name.

After changing colours, test pointer hover and keyboard focus as well as the normal state. Check an unavailable product action too. Mobile touch does not provide a persistent hover state, so keep the default and selected treatments clear without relying on hover.

Local overrides, store style, and template defaults

For each property, the intended order is explicit local page override → store card style → template default. Setting one local property does not intentionally replace the entire store style. For example, a local title colour can differ while the card still inherits store padding and corner radius. Resetting a local property should reveal the store value; resetting the store property should reveal the template value when no local override remains.

The existing listing page's Card · Appearance group includes styling for its grid surface. That is separate from a shared treatment applied to individual card containers. Changing grid spacing or a recommendation rail's surrounding section does not mean you have changed the store-wide card style. The product page's Buybox · Appearance styles its purchase panel, which is also a separate surface from its recommendation cards.

Screen: Store Editor → Pages → Browse → Product Listing → Design → Card · Appearance or Card · Text for local listing properties; Buttons and controls holds its local button roles. A local value shows Overrides store card style. An unset row says Uses store card style when set; otherwise template default. Use Reset to store card style on a local card row to remove that override. For a button role, this resets the role's whole appearance object, not just one colour. These hints apply to listing card and listing button keys; product-detail controls keep their own template support and do not gain a new local recommendation-card editor here.

In the shared panel, use Reset to template default on a row to remove that store override. Reset text clears changed text rows; Reset zone clears changed appearance and text rows; Reset controls clears changed button roles. To clear the whole shared style, choose Reset all product cards to template default and wait for Saved. These store actions do not delete local page overrides.

Rows show Template default or Custom value, and groups count controls changed from template default. These count explicit saved choices, not differences from the last publish. Inside the store style, setting Template default on a background, border, or shadow row keeps the Surface style preset from filling that property. On a page's own card rows, a value left at or set to Template default is treated as unset, so the store style still applies there; only a saved custom value, or a saved button-role appearance, overrides it.

Which surfaces follow the shared style

SurfaceCoverage for this feature
Product-list grid cardsFollow the shared style, with any local listing override on top. This covers the card container, title, price, and detail text and the card's own button in every product-list layout that shows product cards, on desktop and mobile. The Category drilldown layout shows category tiles rather than product cards, so it is not painted. The Auto-configurator stepper layout takes the container, text, and price styling but has no card button to style.
Product-page recommendation, cross-sell, and bundle cardsFollow the shared style. They do not automatically copy the selected product-list template, and the product-detail inspector has no local recommendation-card controls. The container, title, and price are painted on desktop and mobile; these cards have no store-styled button, so the button colour settings do not affect them. In the templates that draw their own cross-sell cards, a value saved in the product page's Related products Appearance group wins over the store style for that one property, and unset properties still follow the store style.
Landing-page product gridsNot yet connected to this store style; configure those sections separately.
Wishlist cardsNot yet connected.
Thank-you recommendationsNot yet connected.
404 recommendationsNot yet connected.

Why does my product page card look different?

First decide which surface you are comparing. The main product gallery and purchase panel are not recommendation cards. They retain their page and zone styling. A recommendation rail can also have its own surrounding spacing, heading, image ratio, or layout even when the card properties match the listing.

Check whether the difference comes from a local listing override. A listing's explicit colour, font, radius, or button treatment wins on that listing; it is not automatically copied to the product-page recommendations. On the listing's card row, use Reset to store card style when both surfaces should follow the shared value. The product-detail inspector has no new local recommendation-card controls in this release. Leaving a shared property unset lets each template choose its own default, so two unconfigured cards can legitimately look different.

If both surfaces should match but do not, confirm that the shared panel reached Saved. Publish any local page changes and open fresh storefront pages. Check that the cards and actions exist in the chosen template and viewport, with populated recommendations. Compare a property covered by the shared style rather than an image crop or rail layout. If a product list still looks unchanged, check the three common causes. The page may have its own saved card value for that property, which wins over the store style; use Reset to store card style on that row. The layout may be Category drilldown, which has no product cards. Or the style may be unset or invalid: the storefront ignores a style it cannot read and falls back to the template rendering, so reset it with Reset all product cards to template default and set it again. On a product page, check the Related products Appearance group in the product-detail inspector: a saved value there (for example a corner radius) keeps that property on the cross-sell cards while the store style paints the rest. Button colours only ever change a card's own button, never the filter or toolbar buttons of the page.

Saving or a stored style failed

If the status remains Saving… or shows Save failed — retry, the change is not confirmed saved. Restore your connection and recheck the save status before leaving. If you see This saved card style is not supported. Reset it to template default before editing., the panel cannot edit that stored value. Reset all product cards to template default clears the shared style; use it only when you intend to discard that style, then wait for Saved.

Fine-tune

The Fine-tune sub-tab lets you adjust individual colour tokens — primary colour, background colour, accent colour — on top of whichever theme pack is currently applied. It also has separate Heading font and Body font pickers. Fine-tune changes layer on top of the theme; they don't modify the underlying theme pack itself, and you can save the result as a custom theme that then appears in the Custom tab.

Choose a type pairing

In Fine-tune, the Typography section starts with a Type pairing drop-down above the separate Heading font, Body font and monospace pickers. Each entry names a heading and body combination, such as Playfair Display + Inter or DM Serif Display + DM Sans; a few are a single family, such as Barlow (single-family).

Open Type pairing

Go to Store Editor → Theme → Fine-tune and find Type pairing under Typography.

Pick a pair

Choose an entry. A specimen appears under the drop-down showing Heading sample in the heading font and Body text sample in the body font. Picking a pair sets both the heading font and the body font together and marks the theme as custom.

Save the theme

Select Save theme. Like every Fine-tune change, the pairing is not live until you save.

Choose Custom at the top of the drop-down to stop using a named pairing. Your current heading and body fonts stay as they are; they simply are no longer tied to a pairing. The same happens when you then pick a font in the Heading font or Body font picker: the drop-down returns to Custom. A store that never chose a pairing shows Custom and its fonts are not changed.

In Store Editor → Site-wide → Branding → Typography, the font control is labelled Body font. Changing it there also clears a chosen pairing back to Custom.

My pairing went back to Custom

Setting the heading font, the body font or the Branding Body font on its own breaks the pair, so the drop-down shows Custom. Pick the pairing again and Save theme to restore both fonts together.

Preview and apply a preset from Fine-tune

Go to Store Editor → Settings → Theme → Fine-tune. The preset cards separate trying a look from applying it, so browsing cannot accidentally replace your edited theme.

Preview a preset

Hover a preset card to preview it in the editor. The preview combines the preset's theme settings (colours and shape treatment) with its own heading font and body font, so a luxury, streetwear, or tech preset previews with its own type pair rather than your saved fonts. If a preset does not define a heading or body font, that font stays as your current one. If you use a keyboard, Tab to the card's Apply button to preview the same preset. Move the pointer off the card, or move keyboard focus away, and the preview returns to the theme you were editing. Nothing is saved during this preview, and the preset is only applied when you select Apply (next step).

Select Apply

Select the explicit Apply button inside the preset card. Selecting the card itself only previews it and does not apply it. The preset already in use shows Active and its Apply button is disabled.

Confirm the preset

In the confirmation dialog, select Apply to stage the preset or Cancel to keep the current theme. Confirmation updates the Fine-tune draft; it does not by itself save that draft.

Save the theme

Select Save theme to persist the staged preset and any other Fine-tune changes. Product-listing and product-detail pages then use the preset's shared colours, fonts, and button radius as described above.

A preset flashed in the preview but did not stay applied

Hover and keyboard focus are temporary try-on states. Return to the card, select its Apply button, confirm the dialog, and then select Save theme. If Apply is disabled, that preset is already active; use the colour and font controls below for further changes.

Changing only the heading font leaves your body font untouched

Picking a font in Heading font and selecting Save theme saves only that heading change — your body font stays exactly as it was, even if the panel's own display briefly shows both fields loaded together. The same is true in reverse: changing only Body font and saving never touches the heading font. Changing a colour token and saving doesn't touch either font. To change both fonts in one save, set both fields before you click Save theme; applying a theme preset, or using Reset, still sets both fonts together as before.

A heading font's fallback now matches its own style family

If a heading font hasn't loaded yet (slow connection, or before the browser finishes fetching it), the storefront shows a fallback font while it waits. That fallback now matches the heading font's own category — a serif heading font (e.g. Playfair Display, DM Serif Display, Merriweather) falls back to a serif system font, and a sans/display heading font (e.g. Space Grotesk, Bricolage Grotesque) falls back to a sans system font — instead of always falling back to the same generic sans font regardless of what you picked. Your body font's fallback is unaffected and keeps its own existing behaviour.

Set exact corner radii

The Corner radius card in Fine-tune offers three presets: Sharp (zero-radius corners), Soft (subtle rounding) and Pill (fully rounded cards and buttons). Under the presets, an Exact corners (px) block lets you set each corner yourself.

Open the corner controls

Go to Store Editor → Settings → Theme → Fine-tune and find Corner radius. The Exact corners (px) block sits directly under the three preset cards.

Type a value per corner

Enter pixels in the Buttons, Cards and Inputs rows. The allowed ranges are 0 to 48 for Buttons, 0 to 48 for Cards and 0 to 24 for Inputs. An empty box shows a dash and means that corner keeps the preset or template value.

Make buttons fully round

Select Pill next to the Buttons row. The Buttons box then shows the placeholder Pill. Select Pill again to switch back to the Soft preset's button radius.

Clear one corner or go back

Clear a box to drop just that corner's value. Select Back to template corners (shown only while at least one exact value is set) to remove all three at once.

Editing a value switches the preset to custom

The block's own hint reads "Changing a value switches the preset to custom." If the three values you type happen to equal one of the Sharp, Soft or Pill presets exactly, that preset shows as selected again.

Typography & buttons

Below the spacing, corner and motion presets, Fine-tune has a Typography & buttons panel. Its description reads: "Store-wide look for titles, headings, buttons, links and product cards. Leave a control empty to keep the template default." Every control is optional, and a control you never touch changes nothing.

Open the panel

Go to Store Editor → Settings → Theme → Fine-tune and scroll to Typography & buttons. It is laid out in six groups: Page titles, Section headings, Card titles, Buttons, Links and Product cards.

Style the three text roles

Page titles, Section headings and Card titles share the same eight controls (shown here for Page title; the other two read "Section heading" and "Card title"):

  • Page title font: choose Heading font or Body font.
  • Page title weight: 300 to 900.
  • Page title case: As typed, UPPERCASE, lowercase or Capitalize.
  • Page title letter spacing: a number in em, from -0.1 to 0.5 in steps of 0.01.
  • Page title line height: 0.8 to 2.5 in steps of 0.05.
  • Page title size, mobile and Page title size, desktop: pixels, 8 to 160.
  • Page title colour: Text, Muted, Accent or On accent.

If you fill in only one of the two sizes, the other is set to the same value.

Style buttons

In Buttons: Button weight (300 to 900), Button case, Button letter spacing (em, -0.1 to 0.5), Button fill (Template default, Accent, Text or Transparent), Button text colour (Text, Muted, Accent or On accent), Button border width (0 to 8 px), Button border colour, Button padding, sides (0 to 96 px), Button padding, top/bottom (0 to 48 px), Button minimum width (0 to 480 px) and Button shadow (Template default or None).

Style links and product cards

In Links: Link underline (Template default, Never or Always), Underline thickness (1 to 4 px) and Underline offset (0 to 12 px). In Product cards: Product card shadow (Template default or None).

Colours are theme choices, not free hex

Text and button colours, and the button fill, offer theme tokens only (Text, Muted, Accent, On accent, Transparent). Button border colour is a colour picker. Custom hex for the token-based controls is not available yet.

Why did my preset become Custom, or my change not show?

Any edit in this panel marks the theme as Custom, so no preset stays selected as the active one. If a button or card looks unchanged, check whether the control still reads Template default or is empty: those keep the template's own look. A size set in only one of the two fields is mirrored to the other, so a "mobile only" size is not possible here.

Identities

The Identities sub-tab applies a complete design direction to your entire storefront — landing page, product listing, checkout, and all 19 page types — in a single click, instead of picking a template per page. Identities are grouped by the plan tier they require: Max Plan, Growth Plan, and Starter.

Browse and preview

Click any Identity card to load it into the live preview panel on the right, rendered as an iframe of your actual storefront.

Press Apply Identity

Available Identities show an Apply Identity button; the Identity currently active on your store shows an Applied badge instead.

Plan gating

If your plan doesn't include the Identity's tier, applying it fails with an upgrade message instead of an error — you'll need to upgrade your plan before that Identity can be applied.

Site-wide Custom CSS is marked Coming soon

Open Store Editor → Site-wide settings → Custom CSS. The panel shows the shared Coming soon badge and an Open Theme settings link, which takes you to Online Store → Theme → Advanced → Custom code. On the classic admin skin that destination is a placeholder with no field to type into. On the newer editorial admin skin, a textarea can preview CSS locally, but its Save button is disabled and labelled Coming soon. There is no backend save endpoint on either skin, so nothing typed there is kept after you leave. Use the Theme Hub's colour tokens and presets for any storefront-wide customisation that must persist. CSS for a single page, the header or the footer does save: see Page Custom CSS.

Head scripts and Body scripts are coming soon

Two more fields sit in the same Online Store → Theme → Advanced → Custom code group as Custom CSS: Head scripts (for tags inside the storefront <head> — analytics, fonts, meta tags) and Body scripts (for scripts injected before </body> — chat widgets, tracking pixels). Both are placeholders today on every admin skin; neither accepts input yet.

Applying a theme preset after an Identity

An Identity gives every standard page its own theme pack as a starting point. If you later apply a different theme preset, your store's standard pages follow the newer preset rather than staying on the Identity's pack. This covers these 14 pages: About, Contact, the 404 (page not found) page, Login, Register, Forgot password, Email verification, Thank you, Order confirmation, Order tracking, Profile, Orders, Order detail and Wishlist. Your header, footer, product listing and product pages already follow the applied preset, so the whole storefront now matches.

Apply an Identity

Go to Online Store → Store Editor → Settings → Theme → Identities, preview an Identity and press Apply Identity, as described above.

Apply a theme preset afterwards

On the same Theme screen, choose a preset from Browse or Featured, select Apply Theme, confirm in the Apply this theme? dialog, and save the theme if the panel asks you to (see Applying a theme).

Check the standard pages on your live storefront

Open your real storefront (see Open your real storefront) and visit the About page, the Contact page, Login and a made-up address such as /no-such-page to see the 404 page. Their colours, fonts and backgrounds should match the preset you applied last, not the Identity's.

Which theme a standard page shows is decided in this order, first match wins:

  1. A theme you chose for that one page. A page-specific theme you saved yourself, one that differs from the theme the Identity gave the page, always wins over the store-wide preset. A page theme that is still the one the Identity seeded does not count as your own pick, so it follows the newer store-wide preset (rule 2).
  2. The store-wide preset you applied last.
  3. The Identity's pack, when you have applied an Identity and no preset.
  4. The default light theme, for a store that never applied an Identity or a preset.

If you hand-picked your own colours instead of a catalogue preset, the store counts as Custom and does not supply a store-wide preset. In that case a standard page keeps the theme it already carries (the Identity's pack, or the default light theme).

A page that carries its own theme (a theme you saved for that page that differs from both the store-wide preset and the Identity) also paints its own background and section surfaces, so its text stays readable instead of mixing that page's text colour with the store preset's background.

Dark theme presets

When the preset you apply is a dark one (for example Abyssal), the whole customer experience turns dark, not only the home page:

  • the cart, checkout, product listing and product detail pages;
  • the 14 standard pages listed above;
  • the header and footer;
  • form fields, so text you type into the checkout address fields, Login, Contact, Profile and the pincode boxes stays readable against the dark field.

Light presets render exactly as they did before; nothing changes for a store on a light preset. The precedence list above applies to a dark preset the same way: a page whose theme is still the one the Identity seeded follows the dark preset, while a page theme you picked yourself keeps its own look. A page you deliberately keep on a light theme stays light with readable text, even on a dark store.

Why is one page still light after I applied a dark preset?

That page has its own saved page theme, which differs from the Identity's theme and therefore outranks the store-wide preset (rule 1 above). Hard refresh the storefront (Ctrl+Shift+R / Cmd+Shift+R) first to rule out a cached copy, and confirm the dark preset shows the Applied badge. Then open that page in the Store Editor and check which theme or Look it uses. Pick the dark theme for that page to make it match the rest of the store. Pages you never picked a theme for follow the dark preset on their own.

Why do my About / Login pages still show the old colours?

Standard pages follow the latest theme preset you applied, with no separate step for them. First check that the preset was applied and saved: the card shows the Applied badge and you saw Theme applied to storefront. Then do a hard refresh of the storefront page (Ctrl+Shift+R / Cmd+Shift+R) so the browser loads the new colours. If the page is still different, it may carry a theme you saved for that single page, which outranks the store-wide preset. A store set to Custom colours also keeps each page's existing theme.

Theme families and what they change

Theme packs group into five families, each defining a different structural and visual language — not just a different colour:

FamilyCharacteristicsExamples
Surface / DepthLayered cards, subtle shadows, clean depth cuesAbyssal, Ceramic, Concrete, Claymorphism
Anti-AestheticBold borders, raw type, high-contrast, intentionally unpolishedNeubrutalism, Brutalist
Retro / FuturistNeon gradients, nostalgic palettes, retrofuture coloursVaporwave, Y2K, Retro Futurism
AtmosphericSoft glows, aurora gradients, ethereal overlaysAurora UI, Glassmorphism
Palette onlyColour palette change only, no structural effectVarious palette packs

For example, Glassmorphism gives your product cards frosted-glass panels with soft blur behind them, while Neubrutalism gives the same cards bold black borders and stark contrast — the theme changes the card structure, not just its colour.

Store-wide, not per-page

Applying a theme — whether from the Theme Hub or from the built-in theme packs shown in the Theme section inside any individual page editor — changes your entire storefront at once. To use a different layout for just one page (without changing your overall theme), use that page's own template picker — see Page-Layout Pickers.

Exception: if you click one of your own saved custom theme packs from inside a page's Theme section (instead of one of the built-in packs), it applies to that page only, and only once you press Save Draft or Publish there — see Custom brand-kit themes in the Theme tab.

The Header and Footer template galleries also show Looks cards. These are not theme presets:

  • In the gallery, the helper above the Look cards reads "Looks change only this header, not your store's theme. Your structure stays." For the Footer it reads "Looks change only this footer, not your store's theme", followed by "Cards marked "Adds N Footer Sections" also add those rows."
  • The structure chips above the cards (named after the header or footer structures) only browse that structure's Looks. Nothing changes until you pick a Look card.
  • A Look therefore never recolours or re-fonts the rest of the storefront.

Change only the header or footer appearance

In the Store Editor, select Header (or Footer), use Change template, and pick a Look card. Only that section changes. To fine-tune individual colours per header row afterwards, see Per-section Design and header-wide looks.

Change the whole store's look instead

Use a theme preset as described above: Online Store → Store Editor → Settings → Theme, choose a preset, select its Apply button, confirm in the dialog, then Save theme.

I picked a Look but my product pages did not change colour

That is expected: a Header or Footer Look is section-only. Apply a theme preset from Settings → Theme when you want fonts and colours to change store-wide.

Next steps