Theme settings
Settings that apply to the whole store: your logo, fonts, colours, page width, buttons, and how prices, stock and ordering work for trade buyers. Open them from the paintbrush icon in the theme editor's left bar.
Brand and social media
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Logo | Always | ||
| Favicon | Always | 32 x 32px .png recommended. |
Social media
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Instagram URL | Always | ||
| Facebook URL | Always | ||
| Pinterest URL | Always | ||
| YouTube URL | Always | ||
| TikTok URL | Always | ||
| X URL | Always |
Typography
Fonts
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Body font | Always | ||
| Heading font | Always | ||
| Data font (monospace) | Always | Used for prices, quantities, SKUs and specifications. A monospace face keeps figures aligned in tables. |
Font scale
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Body font size | Always | ||
| Heading scale | Always | ||
| Base letter spacing | Always |
Layout
Page layout
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Page width | Narrow (1280px) · Standard (1440px) · Wide (1760px) · Full width | Always | |
| Page margin | Always | ||
| Density | Compact · Normal · Spacious | Always | |
| Placeholder style | Color block · Gray | Always | What products and collections without an image look like. |
| Products per row | Always | Desktop only. Narrower viewports fit as many as the column width allows. | |
| Corner radius | Always | Applies to buttons and inputs. Set 0 for square corners. |
Buttons
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Button style | Filled · Outline | Always | For primary buttons like Add to cart. Checkout buttons always stay filled. |
| Uppercase button labels | On · Off | Always | |
| Show back-to-top button | On · Off | Always |
Colors
Color schemes let you set a palette once and apply it per section. Every section has a "Color scheme" setting — that is how you alternate light and dark bands down a page without editing code.
Status colors stay the same in every scheme, because an out-of-stock warning should not change meaning when a section changes palette.
Semantic status colors
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Success color | Always | ||
| Warning color | Always | ||
| Error / danger color | Always | ||
| Info color | Always |
Six colors behind category icons and products without a photo. Choose Custom to set them to your brand; a category card can also pick one by number.
Panel colors
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Palette | Theme default · Custom | Always | |
| Color 1 | Palette is Custom | ||
| Color 2 | Palette is Custom | ||
| Color 3 | Palette is Custom | ||
| Color 4 | Palette is Custom | ||
| Color 5 | Palette is Custom | ||
| Color 6 | Palette is Custom |
Which settings reveal which:
flowchart LR panel_colors_mode["Palette"] panel_color_1["Color 1"] panel_color_2["Color 2"] panel_color_3["Color 3"] panel_color_4["Color 4"] panel_color_5["Color 5"] panel_color_6["Color 6"] panel_colors_mode -- "is Custom" --> panel_color_1 panel_colors_mode -- "is Custom" --> panel_color_2 panel_colors_mode -- "is Custom" --> panel_color_3 panel_colors_mode -- "is Custom" --> panel_color_4 panel_colors_mode -- "is Custom" --> panel_color_5 panel_colors_mode -- "is Custom" --> panel_color_6
B2B · Prices
Who can see prices, and what trade buyers see beside them. Every style installs selling to everyone, so a new store can take orders at once. To sell only to approved trade accounts, first add your companies, locations and catalogs in Shopify admin (Customers → Companies), then choose "Trade buyers only". This hides prices in the theme only; Shopify's catalogs decide what each company can actually buy.
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Who sees prices | Everyone · Trade buyers only | Always | Trade buyers only: guests see products and a sign-in prompt. Trade accounts you put on hold never see prices, under either choice. |
Beside the price
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Show compare-at price | On · Off | Always | Struck through when a product is on sale. Everyone sees it, whoever can see prices. |
| Show retail price comparison | On · Off | Always | Show the base/retail price strikethrough alongside the wholesale price. |
| Show price list badge | On · Off | Always | Display the PriceList name next to prices for B2B customers. |
Preview in the editor
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Preview as | Off · Approved buyer · Guest | Always | Editor only: Guest or Approved trade buyer shows the page that visitor gets, their prices and their sections. Visitors are never affected. |
| Control who sees prices | On · Off | Who sees prices is replaced | Then choose what guests see below. Trade accounts you put on hold see no prices. |
| Guests and retail customers | Hide prices · Show retail prices | Who sees prices is replaced | Hidden prices also hide Add to cart. Signed-in company buyers always see their company's prices. |
Which settings reveal which:
flowchart LR b2b_price_access["Who sees prices"] b2b_enable_price_gating["Control who sees prices"] b2b_visitor_pricing["Guests and retail customers"] b2b_price_access -- "is replaced" --> b2b_enable_price_gating b2b_price_access -- "is replaced" --> b2b_visitor_pricing
B2B · Ordering and stock
Quantity rules and volume prices come from your B2B catalogs. These settings choose what the store shows: quantity rules, stock, and the ordering tools.
Quantities
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Show quantity rule | On · Off | Always | Shows the rule beside the quantity, e.g. "Minimum 12 · multiples of 6". Checkout enforces it regardless. Learn more |
| Cap at available stock | On · Off | Always | Block add-to-cart when quantity exceeds available stock. Shows 'Only N available' message. |
Stock
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Show stock indicator | On · Off | Always | Display in-stock, low-stock and out-of-stock badges on product cards and product pages. |
| Low stock threshold | Always | Quantity below which a variant is considered 'Low stock'. Default: 5. | |
| Show stock without prices | On · Off | b2b_price_access is trade_only | Shows stock to visitors who can't see prices. Prices and quantity rules stay hidden. |
Ordering tools
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Show request a quote | On · Off | Always | Allow customers to submit quote requests from the cart page. |
| Allow variant order matrix | On · Off | Always | Allows the Variant order matrix block: a quantity grid for products with up to two options. |
| Most variants in matrix | Allow variant order matrix is on | Products with more variants show the normal variant picker instead. |
Which settings reveal which:
flowchart LR b2b_enable_variant_matrix["Allow variant order matrix"] b2b_matrix_max_variants["Most variants in matrix"] b2b_enable_variant_matrix -- "on" --> b2b_matrix_max_variants
Sign-in screens
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Image | Always | Beside the sign-in, account and password forms, and on pages that ask a visitor to sign in. Hidden on phones. | |
| Reasons to sign in | Always | One per line, shown with a tick on pages that ask a visitor to sign in. Leave empty to show none. |
B2B · Product page
Specification tables, datasheet downloads, and product lead times.
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Show company on products | On · Off | Always | The buyer's company and location above the product title. The header has its own setting. |
| Show product specifications table | On · Off | Always | Display product metafields in a key-value table on the product page. |
| Show datasheet downloads | On · Off | Always | Lists the product's documents on its page. Learn more |
| Show lead time | On · Off | Always | Shows the product's "ships in" estimate on its page. Learn more |
Cart
How the cart looks and what it tells the buyer.
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Cart type | Cart page · Drawer | Always | Drawer opens the cart beside the page. Notes, PO number and quotes stay on the cart page. |
| Open drawer on add | On · Off | Cart type is Drawer | Applies when Cart type is Drawer. When off, the cart count in the header updates and the buyer keeps browsing. |
| Free shipping from | Always | A whole amount, e.g. 250. Shows buyers how much more they need; set the same rate in shipping. Learn more |
Which settings reveal which:
flowchart LR cart_type["Cart type"] cart_drawer_open_on_add["Open drawer on add"] cart_type -- "is Drawer" --> cart_drawer_open_on_add
Developer
Adds an on-page panel for tuning the header against the design. For local development only — turn it off before publishing.
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Show the tuning panel | On · Off | Always |
Adds an on-page annotation panel for front-end review. For local development only — turn it off before publishing.
| Setting | Choices | Shows when | What it does |
|---|---|---|---|
| Show review comments | On · Off | Always |