Skip to content

How to customize shopfront appearance

Brand, layout, catalog, product cards, cart, SEO, and custom CSS for Hosted Shopfront.

Overview

Settings → Appearance (also Sales Channels → Hosted Shopfront → Manage) opens Customize Shopfront. Changes apply to Hosted Shopfront only, except Cart & Checkout tip/comment flags, which kiosk and QR also read.

Before you start

  • Switch the header to Hosted Shopfront.
  • Open the shopfront in another tab to preview after save.

How to use it

Theme Preset sits above the left menu. It is a starting point for colors, style, store layout, catalog, and product cards. Changing it can merge other sections to match the preset.

The left menu groups:

Customize

  • Brand: tiles Colors (Use Custom Colors, Color Scheme, Brand Colors) and Style (Font Style, Icon Style, Corner Style).
  • Store: tiles Spacing (Layout Density, Section Spacing), Banner (Height, Arrows, Indicators), and Store Details (Store Header, address/hours, Business Links Placement).
  • Catalog: tiles Product Layout and Categories.
  • Products: Show Product Images, then tiles Cards (Card Style, Image Ratio, Image Fit) and Detail (Modal Layout).
  • Cart & Checkout: groups Cart Access (Cart Placement: Bottom checkout strip, Navbar, Floating button), Checkout Strip, Add-to-Cart Feedback, Checkout Modal, Checkout Options (Tipping, Cart-Wide Note, Per-Item Notes), and Cart Footer (Show Footer Message). The Cart Placement hint: Tiered reward progress only appears with the bottom checkout strip.

SEO

  • Page Title, Keywords, Meta Description (stored on the store, not inside the theme JSON).

Advanced

  • Custom CSS and Custom Script.

Save with Update. That saves the whole editor (AJAX).

Related: Homepage Banners in the Appearance menu opens Marketing → Banners.

Understanding the options

Use the short descriptions under each menu item in the editor. If a control is hidden, another setting is blocking it (for example checkout-strip options only when cart placement is the bottom checkout strip). Public Tiered Discount coupons show spend progress on that strip; they do not show if cart placement is Navbar or Floating button. The strip applies the unlocked tier Discount. Choosing a Free Products reward instead is coming soon.

Important

  • Kiosk and QR ignore colors, catalog layout, banners, and custom CSS.
  • Custom scripts run on the shopfront. Use with care.

Common problems

Problem

Kiosk still looks like the default app theme.

Solution

Expected. Only shopfront uses Brand/Catalog layout. Tips still follow Cart & Checkout.

Problem

Appearance page shows a channel banner.

Solution

Switch the header to Hosted Shopfront and save again.