Theme settings
Theme settings apply to the whole store. In the theme editor, click the paintbrush icon to open them. The categories, in the order the editor shows them:
Theme style, Favicon, Colors, Typography, Layout, Drawing sheet, Your space and fit, Buttons, Product cards, Fabrics and samples, Lead times, Cart, Search, Social media.
Defaults below are the theme's own. Each style sets some of them differently, such as the fonts, colors, corner radius and the cart drawing. Styles lists those.
Theme style #
Choose Treadle (the default), Graphite or Drawing Room. This changes the settings on this page, not your templates or content. See styles.
Favicon #
| Setting | What it does | Default |
|---|---|---|
| Favicon image | The small icon in browser tabs and bookmarks. Upload a square PNG, at least 32 × 32 px. Treadle also uses it as the 180 px icon for phone home screens, so a larger source (180 × 180 px or more) looks sharper. | None |
Colors #
Color schemes #
Each section and block area can use a color scheme. A scheme has eight colors:
| Color | Used for |
|---|---|
| Background | The page or section background. |
| Secondary background | Panels, cards and image placeholders. |
| Text | Body text, headings and the outlines of drawings. |
| Muted text | Captions, notes, secondary details. |
| Sheet frame and rules | The frame around the page, hairlines, input borders and dividers. |
| Primary button and selected states | Primary buttons, the selected swatch and option, active filters. |
| Primary button text | Text on primary buttons. Keep a contrast ratio of at least 4.5:1 against the button color. |
| Dimension lines and labels | Dimension lines, their labels, the scale bar and the shopper's wall in drawings. Keep at least 4.5:1 against the background, because the labels are text. |
Every style comes with four schemes: 1 is the page, 2 is a contrast band, 3 is a secondary paper, and 4 is the page with another dimension color (terracotta in the Treadle style). You can add more. The type specimen page shows each scheme's contrast ratios.
Other color settings #
| Setting | What it does | Default |
|---|---|---|
| Page color scheme | The scheme behind every page, and of sections set to it. | Scheme 1 |
| Drawers and dialogs | The cart drawer, the fabric panel, the Your space panel, the mobile filter drawer and other dialogs. | Scheme 1 |
Typography #
| Setting | What it does | Default |
|---|---|---|
| Headings > Font | Font for headings, the product title and, by default, prices. | IBM Plex Sans Condensed SemiBold |
| Size scale | 80% to 130%. Scales every heading size. | 100% |
| Letter spacing on large headings | −40 to 20 thousandths of an em. Negative values tighten large headings. | −10 |
| Use the body font for small headings | Headings and prices under 20 px use the body font. Turn this on for display serifs, whose thin strokes break up at small sizes. | Off |
| Price font | Heading or Body. Prices always use lining figures. Choose the body font when the heading font draws old-style figures (a 0 that reads as an o). | Heading |
| Body > Font | Font for text, buttons (unless set otherwise), inputs and labels. | IBM Plex Sans |
| Base size | 16 to 18 px. Body text never goes below 16 px. | 16 px |
| Measurements > Font | A monospaced font for dimensions, the scale bar and other measurements. Prices and text never use it. | IBM Plex Mono |
| Logo text > Font | Heading font or Body font. Used when the header shows the logo as text. | Heading font |
| Letter spacing | 0 to 300 thousandths of an em, for the logo text. | 160 |
| Set logo text in capitals | Shows the store name in capitals. | On |
Layout #
| Setting | What it does | Default |
|---|---|---|
| Page width | Narrow (1200 px), Standard (1440 px) or Wide (1680 px). The maximum content width. | Standard |
| Side margin on desktop | 16 to 80 px. | 40 px |
| Side margin on mobile | 12 to 32 px. | 20 px |
| Spacing | Compact, Regular or Airy. Space inside sections and between elements. | Regular |
| Space between sections | 24 to 160 px. | 80 px |
| Corner radius > Images | 0 to 24 px. | 0 px |
| Inputs | 0 to 20 px. Text fields and select menus. | 0 px |
| Swatches | 0 to 32 px. Fabric and color swatches. | 0 px |
| Images > Image treatment | How photos sit on product cards, collection cards and image sections. Natural, with a slow zoom on hover: photos fill their frames. Soft shadow that deepens on hover: a soft shadow under product and collection images, no zoom. Studio tiles with a hairline frame: product cards become framed tiles, no zoom. | Natural |
Drawing sheet #
Every page is laid out as a drawing sheet: a frame around the page, the header and footer inside it, and a title block in the footer with the store's name, the page, the scale and the units. Products are drawn from their dimension and shape metafields. See drawings.
| Setting | What it does | Default |
|---|---|---|
| Show the sheet frame | A hairline frame around the page on desktop. The header and footer sit inside it. | On |
| Frame inset | 8 to 32 px from the edge of the screen. | 18 px |
| Show zone marks | Small reference ticks along the frame, as on a printed drawing sheet. | On |
| Drawings > Default units | Centimeters or Inches. Shoppers can switch units in the footer and the Your space panel. Their choice is remembered. | Centimeters |
| Largest drawing scale | 1:5, 1:10 or 1:20. Drawings are never drawn larger than this, even when there's room. | 1:10 |
| Label generated drawings | Shows "Generated drawing" under drawings made from the dimension metafields. Uploaded drawings are labelled "Drawing". | On |
| Hatch below the floor line | Diagonal hatching under the floor line. | On |
Your space and fit #
Shoppers save their wall, room, doorway and ceiling once. Product pages, To scale lists, cards and the cart then compare them with each product's dimensions. See Your space and fit.
| Setting | What it does | Default |
|---|---|---|
| Show Your space in the header | The Your space chip in the header. | On |
| Comfortable clearance | 0 to 40 cm. Fits needs at least this much spare; less reads Tight fit. The doorway check uses it too. | 10 cm |
| Check doorways | Compares the piece with the shopper's doorway (tilted, by the diagonal). The wording stays cautious, and under 2 cm to spare reads "Check delivery access with us". Lights and pieces under 60 cm on their smallest side get no doorway line. | On |
| Minimum clearance above a table | 50 to 95 cm. Pendants warn when a drop leaves less than this above the shopper's table. | 65 cm |
| Too low above a table | 30 to 80 cm. Under this, a pendant reads "too low": it blocks the view across the table. Keep it below the minimum clearance; a higher value counts as the minimum. | 60 cm |
| Fit disclaimer | Shown under the fit lines on the product page. | "Guidance only. Check your own measurements before you order." |
| Header chip shows | Wall or Room. The value the chip shows once the shopper saves it. Without it, the chip shows the next saved value. | Wall |
Buttons #
| Setting | What it does | Default |
|---|---|---|
| Corner radius | 0 to 40 px. Use 28 px or more for pill-shaped buttons. Also applies to option buttons, pills and filter controls. | 0 px |
| Primary button style | Solid or Outline. | Solid |
| Primary button font | Heading font or Body font. | Heading font |
| Button text | Sentence case or Capitals. | Sentence case |
| Outline thickness | 1 to 3 px. Border width of outline buttons. | 1 px |
Product cards #
These settings apply to every product card: collections, search, featured collection, recommendations, recently viewed and Complete the set. Cards show one variant per product: the cheapest, preferring available ones. Its price ("From $2,490"), drawing, fit line and lead time all come from that variant, and the card links to it.
| Setting | What it does | Default |
|---|---|---|
| Image shape | Landscape (4:3), Square, Portrait (4:5), or Match the first image. | Landscape (4:3) |
| Image fit | Fill the frame (crops) or Show the whole image (no crop, background shows around it). | Fill the frame |
| Show the second image on hover | Fades in the product's second image on devices with a mouse. | On |
| Show fabric and color swatches | Reads the product's fabrics (custom.fabrics) or Shopify's native swatches. Values without a swatch color or image are left out. When none of a product's values has one, as after a CSV import, the card shows a count such as "5 color options" instead. | On |
| Swatches to show | 3 to 8. More swatches show as "+145". | 5 |
| Show lead time | The arrival of the variant the card shows, worked out as on the product page: the base lead time plus the weeks its fabric's grade adds. See lead times. | On |
| Use the default lead time when none is set | Shows Default lead time on cards when nothing else sets a lead time. | Off |
| Show vendor | Shows the product's vendor on the card. | Off |
| Show quick add | Products with one variant are added directly. Others link to the product page. | On |
| Show a product's rating only with its reviews | The product page shows the stars and count only when the page has a reviews app block, and links them to it. See reviews. | On |
Fabrics and samples #
Fabric pickers, swatches and the fabric library read the fabric entries described in the setup guide. Without them, products use Shopify's standard options and swatches.
| Setting | What it does | Default |
|---|---|---|
| Fabrics > Fabric option names | Comma-separated. Options with these names use the fabric picker. Capitals are ignored. | Fabric, Upholstery, Material, Finish, Cushion fabric |
| Swatch wording | The word shoppers see for your swatches: Fabric, Finish or Material. It changes texts in the picker, the fabric library, the fabric strip and the cart, such as "24 finishes for this piece" and "Finish sample". Pick Finish for lighting or metalwork, Material for mixed catalogs. | Fabric |
| Grades to leave out of the counts | Grade names or handles, separated by commas, for entries that aren't fabrics, such as powder coats. When a product's list includes entries in these grades, the picker and the fabric panel count them as swatches instead of calling a powder coat a fabric. The fabric library uses this list unless its own setting has one. | Empty |
| Fabric list metafield | Product metafield (namespace.key) that lists the product's fabric entries, linked to the fabric option. | custom.fabrics |
| Fabric metaobject type | Used by the fabric library page, the fabric strip and fabric counts. | fabric |
| Samples > Sample product | One product whose Fabric option uses the same fabric names. Set it to Unlisted. Sample buttons stay hidden until you choose one. See samples. | None |
| Suggested samples per order | 1 to 20. A shopping guide for customers. Sample buttons pause at this number, and the fabric library shows it. See samples. | 5 (3 in every style) |
| Sample note in the cart | Shown under the samples in the cart, for example how and when samples ship. | Empty |
| Samples are free | Turn on when an automatic discount makes samples free. The fabric library then says "free samples per order", and sample buttons without a label of their own say "Order a free sample". A sample product priced at $0 always counts as free. See samples. | Off |
Lead times #
The arrival is the base lead time (the variant's, else the product's) plus the weeks the selected fabric's grade adds. See lead times.
| Setting | What it does | Default |
|---|---|---|
| Default lead time | Used when the variant, the product and the fabric's grade have no lead time, for example "Made to order". Leave empty to show no lead time. | Empty |
| Save lead time on the order | Visible at checkout (Lead time), Admin only (_lead_time) or Don't save. | Visible at checkout |
| Save the longest lead time on the order | Adds a "Longest lead time" cart attribute, updated on every cart change. It shows on the order in the admin. | On |
Cart #
| Setting | What it does | Default |
|---|---|---|
| Cart type | Cart drawer or Cart page: what opens after a product is added. The cart page is always available at /cart. | Cart drawer |
| Show the longest lead time in the cart drawer | The order's arrival in the drawer's notes. The cart page has its own setting in the Cart section. | On |
| Show a small drawing on each line | Each cart line's front elevation (or plan, with the room plan drawing) at the cart's one scale, with its width. | On |
| Delivery note | The Delivery cell of the cart's notes. Leave empty to hide it, or match it to your delivery terms. | Empty |
| Returns note | The Returns cell. Leave empty to hide it, or match it to your return policy, including made-to-order pieces. | Empty |
| Financing note | The Payment cell. Shown only where Shopify offers Shop Pay Installments for the cart. | "Pay over time with Shop Pay Installments at checkout." |
| Your order, drawn | The pieces in the cart drawn together, in the drawer and on the cart page, when the cart has two pieces or more. None; On one floor line, against the shopper's wall; In one room elevation, pendants at their drop; In the shopper's room plan. Samples are left out. | On one floor line |
| Drawer heading | Plain; Sheet count (the item count as a title-block field); Heading face over a ruled line. | Plain |
The cart's notes are a ruled table of Arrives, Delivery, Returns and Payment. Leave a note empty to hide its cell. When one piece makes the whole order wait, the Arrives cell says so: "Ships together when Wren lounge chair is ready".
Search #
| Setting | What it does | Default |
|---|---|---|
| Show suggestions while typing | Predictive search in the header: products, collections, pages and suggested searches. | On |
| Show prices in suggestions | Adds prices to product suggestions. | On |
Social media #
Links appear in the footer's About block when Show social media icons is on.
| Setting | Default |
|---|---|
| Empty | |
| Empty | |
| Empty | |
| TikTok | Empty |
| YouTube | Empty |
| X | Empty |
Paste the full address of your profile, for example https://www.instagram.com/yourstore.