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, Buttons, Product cards, Fabrics and samples, Lead times, Cart, Search, Social media.

Defaults below are those of the Weft style. Veranda and Filament change colors, fonts, corner radius, buttons, spacing, image treatment, card image shape and fabric option names. See Getting started.

Theme style #

Choose Weft, Veranda or Filament. This changes the settings on this page, not your templates or content.

Favicon #

SettingWhat it doesDefault
Favicon imageThe small icon in browser tabs and bookmarks. Upload a square PNG, at least 32 × 32 px. Weft 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 seven colors:

ColorUsed for
BackgroundThe page or section background.
Secondary backgroundPanels, cards and image placeholders.
TextBody text and headings.
Muted textCaptions, notes, secondary details.
Rules and bordersHairlines, input borders, 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.

The Weft style comes with three schemes: scheme 1 is paper, scheme 2 is dark ink (used by the footer and the announcement bar), scheme 3 is a secondary paper. You can add more.

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 mobile filter drawer and other dialogs.Scheme 1

Typography #

SettingWhat it doesDefault
Headings > FontFont for headings and the product title.Newsreader
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.−15
Body > FontFont for text, buttons (unless set otherwise), inputs and labels.Instrument Sans
Base size14 to 18 px. Body text size; other sizes follow it.16 px
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.180
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 with a medium-weight title and tabular prices, no zoom.Natural

Buttons #

SettingWhat it doesDefault
Corner radius0 to 40 px. Use 28 px or more for pill-shaped buttons. Also applies to option buttons on product pages (capped at 28 px).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.

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 lead time of the variant the product page opens on, worked out as on the product page: from the variant, its fabric, the fabric's grade or the product. 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

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
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
Swatch wordingThe word shoppers see for your swatches: Fabric, Finish or Material. It changes texts such as "View all 24 finishes", "Choose a finish" and "Finish sample" in the cart. Pick Finish for lighting or metalwork, Material for mixed catalogs.Fabric (Finish in the Filament style)
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 ("View all 40 swatches") instead of calling a powder coat a fabric. The fabric library uses this list unless its own setting has one.Empty
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
Sample note in the cartShown under the samples in the cart, for example how and when samples ship.Empty

Lead times #

Lead times come from the variant, the fabric, its grade or the product, in that order. See lead times.

SettingWhat it doesDefault
Default lead timeUsed when a product, fabric or variant has no lead time.Made to order
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 cart page has its own setting in the Cart section.On
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.