Settings

Theme settings apply to the whole store. Open them in the theme editor with Theme settings. The groups appear in the order below.

Each table gives the label you see in the editor, the setting name in code (used if you edit the theme files), what the setting does and its default.

Logo and favicon

Label Name What it does Default
Logo logo The store logo in the header. None
Logo width logo_width The width of the logo, from 40 to 300 pixels. 120
Favicon favicon The icon in the browser tab. Shown at 32 x 32 px. None

Colors

Label Name What it does Default
Color schemes color_schemes The color sets that sections pick from with their Color scheme setting. Set in the editor
Sale badge background badge_sale_background Background of the sale badge. #BF2F1F
Sale badge text badge_sale_text Text on the sale badge. #FFFFFF
Sold out badge background badge_soldout_background Background of the sold out badge. #4A4A4A
Sold out badge text badge_soldout_text Text on the sold out badge. #FFFFFF
Success message text color_success Color of success messages, such as a quote that was sent. #156C3A
Error message text color_error Color of error messages. #B42318
Stock tape: in stock tape_in Color of the stock tape for in stock items. #14664A
Stock tape: due in tape_due Color of the stock tape for items due in. #1F5A8A
Stock tape: made to order tape_mto Color of the stock tape for made to order items. #66407F
Stock tape: out of stock tape_out Color of the stock tape for out of stock items. #2F4858
Stock tape text tape_text Text on the stock tape. #FFFFFF
Focus ring color_focus The outline that shows which control has keyboard focus. #1F5A8A

Typography

Label Name What it does Default
Font (first one) type_heading_font The font for headings. Barlow Condensed (barlow_condensed_n7)
Size scale (first one) type_heading_scale Heading size, from 80 to 140. The default 100 is normal size. 100
Letter case type_heading_case Default or Uppercase for headings. Default
Font (second one) type_body_font The font for body text. Barlow (barlow_n4)
Size scale (second one) type_body_scale Body text size, from 85 to 125. The default 100 is normal size. 100

The two Font settings and the two Size scale settings share a label. The first set applies to headings. The second set applies to body text.

Layout

Label Name What it does Default
Page width max_page_width The widest content width: Narrow (80rem), Standard (85rem), Medium (90rem) or Wide (105rem). Standard (85rem)
Page margin min_page_margin The space at each side of the page, from 12 to 64 pixels. 20
Grid spacing grid_gap The space between items in a grid, from 0 to 40 pixels. 16

Corners and borders

Label Name What it does Default
Button corner radius button_corner_radius Rounding of buttons, from 0 to 40 pixels. 0
Input corner radius input_corner_radius Rounding of form fields, from 0 to 24 pixels. 0
Card corner radius card_corner_radius Rounding of product cards, from 0 to 32 pixels. 0
Image corner radius media_corner_radius Rounding of images, from 0 to 32 pixels. 0
Border thickness border_width Thickness of borders, from 1 to 3 pixels. 1

Product cards

Label Name What it does Default
Image ratio card_image_ratio The shape of card images: Adapt to image, Square, Portrait or Landscape. Square
Image fit card_image_fit Fit shows the whole image. Fill crops it to the shape. Fit
Show second image on hover card_show_secondary_image Shows a second image when the buyer moves over the card. On
Show vendor card_show_vendor Shows the brand on cards. Off
Show SKU card_show_sku Shows the SKU on cards. Off
Show product rating card_show_rating Shows the rating. You need a product review app for ratings. Off
Show swatches card_show_swatches Shows colour or option swatches. On
Show quick add card_show_quick_add Shows the quick add button. On
Show badges card_show_badges Shows sale and sold out badges. On

Prices

Label Name What it does Default
Show currency codes currency_code_enabled Shows the currency code beside prices. Off
Show tax and shipping note show_tax_note Shows a note about tax and shipping under prices. On
Show second tax price price_dual_tax Shows a second price with or without tax. It is an estimate. Off
Tax rate price_tax_rate The rate used for the second tax price, from 0 to 30 percent in steps of 0.5. 20
Show price per unit price_show_unit Shows the price for each unit when a pack size is set. On

Cart

Label Name What it does Default
Cart type cart_type Drawer shows the cart in a drawer. Page shows the cart on its own page. Drawer
Show order note cart_show_note Shows a note field in the cart. On
Show vendor cart_show_vendor Shows the brand for each cart line. Off
Label Name What it does Default
Enable search suggestions predictive_search_enabled Shows suggestions as the buyer types. On
Show vendor predictive_search_show_vendor Shows the brand in suggestions. Off
Show price predictive_search_show_price Shows the price in suggestions. On

Social media

Each setting takes the full web address of your account. Leave a setting blank to hide that icon.

Label Name
Facebook social_facebook_link
Instagram social_instagram_link
YouTube social_youtube_link
TikTok social_tiktok_link
X (Twitter) social_x_link
Pinterest social_pinterest_link
LinkedIn social_linkedin_link
WhatsApp social_whatsapp_link

The default for each is blank.

Trade and B2B

Label Name What it does Default
Trade price visibility trade_price_visibility Everyone shows prices to all visitors. Signed-in customers only hides prices from guests and shows a sign-in link. This does not secure prices. See B2B. Everyone
Sign-in link label trade_login_label The text of the sign-in link that replaces prices. Blank uses the default text. Blank
Show company in header trade_show_company Shows the company and location in the header for trade buyers. Off
Trade account page trade_account_page The page for trade account applications. None
Quick order page quick_order_page The page for the quick order pad. When blank, the header opens the pad in a dialog. None
Re-order page reorder_page The page that lists past orders for re-ordering. None
Enable quote requests quote_enabled Turns quote requests on. On
Quote response time quote_response_text The text on the quote form, for example a response time. We reply within 2 working hours
Show reference field in cart po_reference_enabled Shows a reference field in the cart for retail buyers. Off

Stock and delivery

Label Name What it does Default
Stock count display stock_display Exact count shows the number in stock. Count when low shows the number only when stock is low. Status only shows only the stock status. Count when low
Low stock threshold stock_low_threshold Stock at or below this number is shown as low stock. Range 0 to 50. 5
Default lead time in working days lead_time_default The lead time for products with no lead time field when they are not in stock. 3
Dispatch cut-off text dispatch_cutoff_text Text shown next to the stock line, for example a same-day dispatch cut-off. Order by 5 pm for same-day dispatch
Show stock by location stock_show_locations Shows stock for each location on the product page. On

Product data

These settings hold the metafield names for the eight product fields. See Product data for each field and its type.

Label Name Default
Part number metafield mf_mpn custom.mpn
Pack size metafield mf_pack_size custom.pack_size
Pack unit metafield mf_pack_unit custom.pack_unit
Minimum order metafield mf_min_order custom.minimum_order
Order multiple metafield mf_order_multiple custom.order_multiple
Lead time metafield mf_lead_time custom.lead_time_days
Specifications metafield mf_specs custom.specifications
Documents metafield mf_documents custom.documents

Catalog

Label Name What it does Default
Catalog menu catalog_menu The menu with your category tree, up to three levels. main-menu
Default collection view collection_default_view The view a collection starts in: Table, List or Grid. Table
Enable compare compare_enabled Turns on compare for products. On
Enable quick view quick_view_enabled Turns on the quick view window for products. On
Enable recently viewed products recently_viewed_enabled Shows products the buyer viewed recently. On