Settings reference
Theme settings live in Customize → Theme settings. Section and block settings live in the sidebar of the page you are editing.
Typography
| Setting | Default | What it does |
|---|---|---|
| Heading font | Work Sans 600 | Headings across the store. |
| Body font | Work Sans 400 | Body copy, labels and buttons. |
| Base text size | 16px | 13–20px. Every other size scales from this. |
| Heading scale | Balanced | Compact, Balanced, Spacious or Dramatic. Sets how much bigger each heading level is than the last. |
| Heading weight | 600 | 400–900. Your font must include the weight you pick. |
| Heading case | None | None or uppercase. |
| Heading letter spacing | 0 | −5 to 10. Useful to tighten large headings or open up uppercase ones. |
Colors
Carton checks colour choices against accessibility contrast targets — keep body text at 4.5:1 or better against the page background, and text on the accent colour at 4.5:1 against the accent.
| Setting | Used for |
|---|---|
| Page background | The page itself. Body text contrast is measured against this. |
| Card background | Cards, drawers and wells. |
| Borders | Dividers and input outlines. |
| Body text | Main text colour. |
| Secondary text | Captions and supporting detail. |
| Accent | Primary buttons and links. |
| Text on accent | Label colour inside primary buttons. |
| Success / Warning / Error | Wholesale messages — minimum quantities, volume price break prompts, and form errors. |
Layout
| Setting | Default | What it does |
|---|---|---|
| Page width | Medium | Narrow, Medium or Wide. Wide suits large catalogs with dense product grids. |
| Page margin | 20px | Space between content and the screen edge. |
| Spacing unit | 4px | The step every other spacing value is built from. Raising it loosens the whole theme at once. |
| Space between sections | 48px | Vertical rhythm between page sections. |
Corners
Separate radius values for inputs, buttons and cards, 0–32px each. Set all three to 0 for a utilitarian, industrial look.
Wholesale
These settings control display only. Companies, catalogs, quantity rules and volume pricing are configured in your Shopify admin. Full detail on Wholesale features.
| Setting | Default | What it does |
|---|---|---|
| Hide pricing from non-wholesale visitors | Off | When on, only signed-in wholesale buyers see prices — everywhere, including collection and search results. |
| Sign-in prompt | “Sign in to see pricing” | Shown in place of a hidden price. Write your own. |
| Also hide add to cart | Off | Some wholesalers hide prices but still take enquiries. Leave off to keep ordering open. |
| Show company and location | On | Shows buyers which company and location they are ordering for. |
| Show quantity rules | On | Minimum, maximum and increment messages. Nothing shows for products without rules. |
| Show volume pricing table | On | A price break table on the product page. Nothing shows for products without breaks. |
Accessibility
The focus outline is what keyboard and screen reader customers follow around the page. Carton exposes its colour, width (0–8px) and offset (0–8px) so it stays visible against your background. Keep it high contrast.
Section settings worth knowing
| Section | Settings |
|---|---|
| Header | Logo and logo width, menu, customer account menu, show search, open cart in a drawer, sticky header, vertical padding. |
| Footer | Menu and menu heading, newsletter signup with heading and text, country and language pickers, Follow on Shop button, payment icons. |
| Collection | Products per page, columns on desktop (mobile is always two), show filters, show sorting. |
| Recommendations | Recommendation type — Related is generated by Shopify; Complementary uses the products you pick in Search & Discovery — and how many to show. |
| Quick order | Allow pasting and CSV upload; restrict the page to wholesale buyers only. |