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.