Documentation menu

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 #

SettingWhat it doesDefault
Favicon imageThe 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:

ColorUsed for
BackgroundThe page or section background.
Secondary backgroundPanels, cards and image placeholders.
TextBody text, headings and the outlines of drawings.
Muted textCaptions, notes, secondary details.
Sheet frame and rulesThe frame around the page, hairlines, input borders and dividers.
Primary button and selected statesPrimary buttons, the selected swatch and option, active filters.
Primary button textText on primary buttons. Keep a contrast ratio of at least 4.5:1 against the button color.
Dimension lines and labelsDimension 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 #

SettingWhat it doesDefault
Page color schemeThe scheme behind every page, and of sections set to it.Scheme 1
Drawers and dialogsThe cart drawer, the fabric panel, the Your space panel, the mobile filter drawer and other dialogs.Scheme 1

Typography #

SettingWhat it doesDefault
Headings > FontFont for headings, the product title and, by default, prices.IBM Plex Sans Condensed SemiBold
Size scale80% 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 headingsHeadings 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 fontHeading 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 > FontFont for text, buttons (unless set otherwise), inputs and labels.IBM Plex Sans
Base size16 to 18 px. Body text never goes below 16 px.16 px
Measurements > FontA monospaced font for dimensions, the scale bar and other measurements. Prices and text never use it.IBM Plex Mono
Logo text > FontHeading font or Body font. Used when the header shows the logo as text.Heading font
Letter spacing0 to 300 thousandths of an em, for the logo text.160
Set logo text in capitalsShows the store name in capitals.On

Layout #

SettingWhat it doesDefault
Page widthNarrow (1200 px), Standard (1440 px) or Wide (1680 px). The maximum content width.Standard
Side margin on desktop16 to 80 px.40 px
Side margin on mobile12 to 32 px.20 px
SpacingCompact, Regular or Airy. Space inside sections and between elements.Regular
Space between sections24 to 160 px.80 px
Corner radius > Images0 to 24 px.0 px
Inputs0 to 20 px. Text fields and select menus.0 px
Swatches0 to 32 px. Fabric and color swatches.0 px
Images > Image treatmentHow 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.

SettingWhat it doesDefault
Show the sheet frameA hairline frame around the page on desktop. The header and footer sit inside it.On
Frame inset8 to 32 px from the edge of the screen.18 px
Show zone marksSmall reference ticks along the frame, as on a printed drawing sheet.On
Drawings > Default unitsCentimeters or Inches. Shoppers can switch units in the footer and the Your space panel. Their choice is remembered.Centimeters
Largest drawing scale1:5, 1:10 or 1:20. Drawings are never drawn larger than this, even when there's room.1:10
Label generated drawingsShows "Generated drawing" under drawings made from the dimension metafields. Uploaded drawings are labelled "Drawing".On
Hatch below the floor lineDiagonal 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.

SettingWhat it doesDefault
Show Your space in the headerThe Your space chip in the header.On
Comfortable clearance0 to 40 cm. Fits needs at least this much spare; less reads Tight fit. The doorway check uses it too.10 cm
Check doorwaysCompares 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 table50 to 95 cm. Pendants warn when a drop leaves less than this above the shopper's table.65 cm
Too low above a table30 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 disclaimerShown under the fit lines on the product page."Guidance only. Check your own measurements before you order."
Header chip showsWall or Room. The value the chip shows once the shopper saves it. Without it, the chip shows the next saved value.Wall

Buttons #

SettingWhat it doesDefault
Corner radius0 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 styleSolid or Outline.Solid
Primary button fontHeading font or Body font.Heading font
Button textSentence case or Capitals.Sentence case
Outline thickness1 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.

SettingWhat it doesDefault
Image shapeLandscape (4:3), Square, Portrait (4:5), or Match the first image.Landscape (4:3)
Image fitFill the frame (crops) or Show the whole image (no crop, background shows around it).Fill the frame
Show the second image on hoverFades in the product's second image on devices with a mouse.On
Show fabric and color swatchesReads 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 show3 to 8. More swatches show as "+145".5
Show lead timeThe 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 setShows Default lead time on cards when nothing else sets a lead time.Off
Show vendorShows the product's vendor on the card.Off
Show quick addProducts with one variant are added directly. Others link to the product page.On
Show a product's rating only with its reviewsThe 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.

SettingWhat it doesDefault
Fabrics > Fabric option namesComma-separated. Options with these names use the fabric picker. Capitals are ignored.Fabric, Upholstery, Material, Finish, Cushion fabric
Swatch wordingThe 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 countsGrade 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 metafieldProduct metafield (namespace.key) that lists the product's fabric entries, linked to the fabric option.custom.fabrics
Fabric metaobject typeUsed by the fabric library page, the fabric strip and fabric counts.fabric
Samples > Sample productOne 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 order1 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 cartShown under the samples in the cart, for example how and when samples ship.Empty
Samples are freeTurn 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.

SettingWhat it doesDefault
Default lead timeUsed 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 orderVisible at checkout (Lead time), Admin only (_lead_time) or Don't save.Visible at checkout
Save the longest lead time on the orderAdds a "Longest lead time" cart attribute, updated on every cart change. It shows on the order in the admin.On

Cart #

SettingWhat it doesDefault
Cart typeCart 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 drawerThe 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 lineEach cart line's front elevation (or plan, with the room plan drawing) at the cart's one scale, with its width.On
Delivery noteThe Delivery cell of the cart's notes. Leave empty to hide it, or match it to your delivery terms.Empty
Returns noteThe Returns cell. Leave empty to hide it, or match it to your return policy, including made-to-order pieces.Empty
Financing noteThe Payment cell. Shown only where Shopify offers Shop Pay Installments for the cart."Pay over time with Shop Pay Installments at checkout."
Your order, drawnThe 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 headingPlain; 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".

SettingWhat it doesDefault
Show suggestions while typingPredictive search in the header: products, collections, pages and suggested searches.On
Show prices in suggestionsAdds prices to product suggestions.On

Social media #

Links appear in the footer's About block when Show social media icons is on.

SettingDefault
InstagramEmpty
PinterestEmpty
FacebookEmpty
TikTokEmpty
YouTubeEmpty
XEmpty

Paste the full address of your profile, for example https://www.instagram.com/yourstore.