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.
Featured tab
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
- Open Online Store → Theme.
- 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.
- 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.
| Control | Choices and intended result |
|---|---|
| Surface style | None, 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 radius | None, Sm, Md, Lg, or Xl changes the card container's rounding. It does not promise to change the image crop or rounding inside it. |
| Padding | None, Sm, Md, or Lg sets space between the card's content and its edges. |
| Margin | None, Sm, Md, or Lg adds space above and below the card container; it does not change the page gutters. |
| Border width | None, Thin, Medium, or Thick controls the card outline's thickness. A border colour needs a visible width to be seen. |
| Border colour | A theme colour follows the theme; a custom colour fixes the outline colour. |
| Background colour | Sets the card container's background without changing the product image itself. |
| Shadow | None, Sm, Md, or Lg changes the card's elevation. Check contrast against the page background. |
| Inner gap | Sm, 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 colour | Sets 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 element | Choices and intended result |
|---|---|
| Font role or family | Body 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 scale | Xs, Sm, Base, Lg, Xl, 2xl, 3xl, or 4xl chooses a named text size. Larger sizes adapt to the viewport. |
| Weight | 300, 400, 500, 600, 700, or 800 changes emphasis; the chosen font also affects the result. |
| Style | Normal or Italic changes the text treatment. |
| Letter spacing | Tight, Normal, Wide, or Wider changes spacing between letters. |
| Case | None, Uppercase, Lowercase, or Capitalize changes display case without rewriting your catalogue. |
| Alignment | Start, Center, End, or Justify aligns text within its element. |
| Colour | Sets 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 role | Choices and intended result |
|---|---|
| Shape | Square, Rounded, or Pill sets the preset rounding. |
| Fill style | Solid, Outline, or Ghost sets the base treatment. Outline and Ghost keep the base background transparent. |
| Size | Sm, Md, or Lg sets preset padding. |
| Full width | Makes the button fill its available container width. |
| Fill | Solid or Gradient chooses how the background is authored with the solid fill treatment. |
| Solid colour | Sets the colour when Fill is Solid. |
| Gradient angle | When Fill is Gradient, sets the blend direction from 0 to 360 degrees. |
| Start colour; End colour | Set the two ends of the gradient. |
| Text colour | Sets the button label colour in its normal state. |
| Border colour | Sets the normal-state outline colour. |
| Hover background colour | Changes the background while a pointer hovers over an interactive button. |
| Hover text colour | Changes the label colour on hover. |
| Hover border colour | Changes the outline colour on hover. |
| Selected background colour | Changes the background when the template marks the action selected. |
| Selected text colour | Changes the selected label colour. |
| Selected border colour | Changes the selected outline colour. |
| Disabled background colour | Changes the unavailable button's background without making it actionable. |
| Disabled text colour | Changes the unavailable label colour; keep it readable. |
| Disabled border colour | Changes the unavailable outline colour. |
| Focus ring colour | Makes keyboard focus recognizable against the surrounding surface. |
| Corner radius | A 0–999px override takes priority over the preset shape. |
| Border width | A 0–8px override sets outline thickness. |
| Horizontal padding | A 0–96px override sets left and right inner spacing, taking priority over the size preset. |
| Vertical padding | A 0–48px override sets top and bottom inner spacing, taking priority over the size preset. |
| Named style | A 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
| Surface | Coverage for this feature |
|---|---|
| Product-list grid cards | Follow 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 cards | Follow 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 grids | Not yet connected to this store style; configure those sections separately. |
| Wishlist cards | Not yet connected. |
| Thank-you recommendations | Not yet connected. |
| 404 recommendations | Not 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:
- 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).
- The store-wide preset you applied last.
- The Identity's pack, when you have applied an Identity and no preset.
- 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:
| Family | Characteristics | Examples |
|---|---|---|
| Surface / Depth | Layered cards, subtle shadows, clean depth cues | Abyssal, Ceramic, Concrete, Claymorphism |
| Anti-Aesthetic | Bold borders, raw type, high-contrast, intentionally unpolished | Neubrutalism, Brutalist |
| Retro / Futurist | Neon gradients, nostalgic palettes, retrofuture colours | Vaporwave, Y2K, Retro Futurism |
| Atmospheric | Soft glows, aurora gradients, ethereal overlays | Aurora UI, Glassmorphism |
| Palette only | Colour palette change only, no structural effect | Various 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.
Header and Footer Looks change only that section
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.