Mercantile Supply · Merchant guide

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

Learn more