Theme settings reference

Every global setting, as it appears in the theme editor. Open them in the theme editor under Customize › Theme settings.

Logo and favicon
Colors
Typography
Layout and style
Industry
Store mode
Payment messaging
Delivery estimate
Cart
Product cards and badges
Shopping tools
Trust and promises
Region
Age verification
Search engines
Social media
Licence

Logo and favicon

Setting	Type	Details
Logo	image picker	Leave empty to use the logo from Settings > Brand in your Shopify admin.
Logo for dark mode	image picker	Optional. Shown instead of the logo while dark mode is on (needs Colors > Light, dark and system mode). Use a light version of your logo so it stays visible on dark backgrounds.
Logo width (desktop)	range	Range: 60–300px Default: 170
Logo width (mobile)	range	Range: 60–220px Default: 130
Favicon	image picker	32 x 32px .png recommended. Leave empty to use the square logo from Settings > Brand.

Colors

Setting	Type	Details
Use brand colors	checkbox	Uses the primary and secondary colors from Settings > Brand in your Shopify admin for buttons and accents in every color scheme. Off by default, so the colors chosen below stay as they are. Default: off
color_schemes	color scheme group

Light, dark and system mode

Setting	Type	Details
Show a light, dark and system mode button	checkbox	Adds a button to the header that switches between your normal colors, dark mode and the visitor's device setting (system). It starts on system, so visitors whose device is set to dark see dark mode until they choose otherwise. Their choice is remembered on that device. Default: off
Dark mode color scheme	color scheme	Every section uses this scheme while dark mode is on. Pick a scheme with a dark background and light text. Default: scheme-3

Typography

Setting	Type	Details
Headings	font picker	Default: inter_n7
Body	font picker	Default: inter_n4
Heading size	range	Range: 80–140% Default: 100
Body size	range	Range: 90–120% Default: 100

Layout and style

Setting	Type	Details
Page width	select	Options: Narrow, Standard, Wide Default: 1400px
Corner radius (cards, images)	range	Range: 0–24px Default: 12
Button corner radius	range	Range: 0–40px Default: 10
Lift cards on hover	checkbox	Default: on
Subtle animations	checkbox	Default: on
Show back-to-top button	checkbox	Appears after the visitor scrolls about two screens down. Scrolls instantly when the visitor prefers reduced motion. Default: off
Back-to-top position	select	Options: Bottom right, Bottom left Default: right

Industry

Tunes wording, icons and product page features to your type of business. Pair it with a theme style (preset) for matching colours and fonts.

Setting	Type	Details
Business type	select	Options: General store, Tech, electronics and hardware, Fashion and accessories, Beauty and wellness, Home and garden, Food and drink, Sports and outdoors, Toys and kids, Pets, Auto parts, Gifts and occasions, Books and education, Art and entertainment, Wholesale and B2B, Services and bookings, Digital products Default: general
'Add to cart' button text	text	Leave empty for the business type default (e.g. 'Book now' for services).
What you sell (singular)	text	Used in a few headings, e.g. 'product', 'service', 'treatment'. Leave empty for the default.

Store mode

Choose how customers buy. Catalogue hides prices and cart. Quote replaces Add to cart with a quote request. Useful for trade, B2B and service businesses.

Setting	Type	Details
Mode	select	Options: Online shop, Catalogue (no prices, no cart), Request a quote, Shop + quote button Default: shop
Quote request page	page	A page using the 'quote' template (or 'Contact'). The product name is filled in automatically.
Quote button label	text	Default: Request a quote
Show prices only to signed-in customers	checkbox	Default: off
Trade sign-in prompt	checkbox	Shows a sign-in link for guests on product pages and quick order lists, for stores with trade (B2B) accounts. Signed-in trade buyers always see their company and location in the header and their payment terms in the cart. Needs a Full licence. Default: off
Prompt text	text	Blank uses "Trade account? Sign in for your prices."

Payment messaging

Pay-later messages are built in, so no extra apps or scripts are needed. Each provider only shows inside its price limits and in the countries you list.

Setting	Type	Details
Show on product pages	checkbox	Default: on
Show on product cards	checkbox	Default: off
Show in cart and cart drawer	checkbox	Default: on
Style	select	Options: One line per provider, Compact (cheapest instalment + logos) Default: compact

Afterpay / Clearpay

Setting	Type	Details
Enable	checkbox	Default: off
Minimum order	number	Default: 1
Maximum order	number	Default: 2000
Countries (ISO codes)	text	Default: AU,NZ,US,CA,GB
Use Afterpay's official widget instead	checkbox	Loads Afterpay's own script (popup with full terms). Needs the Afterpay app installed. Default: off

Zip

Setting	Type	Details
Enable	checkbox	Default: off
Minimum order	number	Default: 1
Maximum order	number	Default: 5000
Countries (ISO codes)	text	Default: AU,NZ,US
Instalments	select	Options: 4, 6 Default: 4
Use Zip's official widget instead	checkbox	Loads Zip's own script. Needs the Zip app (merchant id is read from the Zip app automatically). Default: off

Klarna

Setting	Type	Details
Enable	checkbox	Default: off
Minimum order	number	Default: 35
Maximum order	number	Default: 2000
Countries (ISO codes)	text	Default: AU,NZ,US,CA,GB,DE,AT,NL,BE,FR,IT,ES,SE,NO,FI,DK,IE

PayPal Pay in 4

Setting	Type	Details
Enable	checkbox	Default: off
Minimum order	number	Default: 30
Maximum order	number	Default: 2000
Countries (ISO codes)	text	Default: AU,US,GB,FR,DE,IT,ES

Shop Pay Installments

Setting	Type	Details
Show Shopify's Shop Pay Installments banner	checkbox	Shown only where Shopify supports it. Default: on

Interest-free finance (e.g. Humm, Latitude)

Setting	Type	Details
Enable	checkbox	Default: off
Provider name	text	Default: Humm
Minimum order	number	Default: 500
Months interest free	number	Default: 12
Countries (ISO codes)	text	Default: AU,NZ

Bank transfer

Setting	Type	Details
Show bank transfer note on large orders	checkbox	Default: off
Show from order value	number	Default: 4000
Note	text	Default: Business order? Pay by bank transfer (EFT) at checkout.

Delivery estimate

Setting	Type	Details
Show estimated delivery dates	checkbox	Default: on
Same-day dispatch cut-off (hour, store time)	range	Range: 0–23 Default: 13
Processing days	range	Range: 0–10 Default: 1
Transit days (min)	range	Range: 0–30 Default: 2
Transit days (max)	range	Range: 1–45 Default: 6
Per-country transit days	textarea	One per line: country code, min, max. Example: NZ,5,9
Count business days only	checkbox	Default: on
Non-dispatch dates	textarea	One date per line, YYYY-MM-DD

Cart

Setting	Type	Details
Cart type	select	Options: Drawer, Page, Pop-up notification Default: drawer
Show free shipping progress bar	checkbox	Default: on
Free shipping threshold (store currency)	number	Default: 99
Enable order notes	checkbox	Default: on
Gift wrap product	product	Pick a product (for example 'Gift wrapping', priced as you like). The cart then offers it as a tick box. Leave empty to hide gift wrapping.
Ask for a gift message	checkbox	Default: on
Suggest products from (empty cart / upsell)	collection

Product cards and badges

Setting	Type	Details
Image shape	select	Options: Square, Portrait, Landscape Default: 1/1
Show whole image (no crop)	checkbox	Best for product shots on white. Default: on
Show brand	checkbox	Default: on
Show SKU	checkbox	Default: off
Show stock status	checkbox	Default: on
Quick add button	checkbox	Default: on
Quick view for products with options	checkbox	"Choose options" opens a pop-up with the option pickers and add to cart instead of going to the product page. Default: on
Show second image on hover	checkbox	Default: on
Option values on cards	checkbox	Shows up to six values of one option (for example colours) under the title. Picking one switches the card's image, price and link. Default: off
Option to show	text	Option names to look for, separated by commas. Without a match, the first option with Shopify swatches is used. Default: Color,Colour

Badges

Setting	Type	Details
Sale badge	checkbox	Default: on
Sale badge text	select	Options: Sale, Percent off, Amount off Default: percent
'New' badge for products added in the last (days, 0 = off)	range	Range: 0–60 Default: 14
Low stock warning at or below (0 = off)	range	Range: 0–50 Default: 5
Custom badge metafield	text	namespace.key of a text metafield, e.g. custom.badge Default: custom.badge
Gift promo metafield namespace	text	Reads the metafields [namespace].promo_gift and [namespace].promo_ends (YYYY-MM-DD). Default: custom

Shopping tools

Setting	Type	Details
Product compare	checkbox	Default: on
Maximum products to compare	range	Range: 2–4 Default: 4
Specification metafields namespace	text	Text, number and boolean metafields in this namespace are shown as specs and used for compare. Default: specs
Spec labels	textarea	One per line, key: label, for example cable_length: Length. Replaces the name made from the metafield key in the specifications table and product compare. Needs a Full licence.
Spec units	textarea	One per line, key: unit, for example cable_length: m. Added after the value in the specifications table, product compare and filters. Needs a Full licence.
Sort number filters by value	checkbox	Lists the values of number metafield filters as 2, 10, 25 rather than 10, 2, 25. Needs a Full licence. Default: off
From and to boxes on number filters	checkbox	Adds From and To boxes above number metafield filters; applying them ticks every value in the range. Filters come from the Search & Discovery app. Needs a Full licence and JavaScript (without it the plain list shows). Default: off
Wishlist	checkbox	Default: on
Track recently viewed products	checkbox	Default: on
Sticky add-to-cart bar on product pages	checkbox	Default: on
Search suggestions	checkbox	Default: on

Pre-orders

Setting	Type	Details
Show pre-orders	checkbox	A variant is on pre-order when its stock is 0 or below and 'Continue selling when out of stock' is on, or when its preorder metafield is true. The button reads Pre-order, a shipping note shows under it, and the order line records it. Default: off
Default pre-order note	text	Used when the variant or product has no preorder_ships date. Leave empty for the default text.
Pre-order metafield namespace	text	Reads the preorder (true or false) and preorder_ships (date) metafields in this namespace, on the variant first, then the product. Default: custom

Trust and promises

Setting	Type	Details
Price promise (shown near price)	text	Leave empty to hide. Example: Price match promise
Price promise link	url
Warranty line	text	Default: Genuine products with manufacturer warranty
Returns line	inline richtext	Default: Easy returns
Secure checkout line	text	Default: Secure checkout

Region

Setting	Type	Details
Home country (ISO code)	text	Used to show local-only messages such as GST and local shipping notes. Default: AU
Message for home-country visitors	text	Example: Prices include GST
Message for overseas visitors	text	Example: Duties and taxes may apply on delivery

Age verification

Asks visitors to confirm their age before they can browse. It does not open in the theme editor; check it in the preview.

Setting	Type	Details
Enable age verification	checkbox	Default: off
Minimum age	number	Default: 18
Heading	text	Leave blank to use: Are you [age] or older?
Text	textarea	Leave blank to use: You must be [age] or older to enter this store.
Redirect visitors who decline to	url	Leave blank to show a message instead.
Remember confirmation for	range	Range: 1–90d Default: 30

Search engines

Setting	Type	Details
Name added to page titles	text	Leave empty to use the store name.
Title separator	select	Options: Dash (–), Vertical bar (\|) Default: dash
Add the name to page titles	select	Options: Always, Only to short titles, Never Default: always
Short title length (characters)	range	Range: 20–70 Default: 40
Use the last part of nested collection names	checkbox	A collection named "Computers > Laptops" gets the title "Laptops". Default: off
Home page title	text	Leave empty to use the home page title from your Shopify preferences.
Collection description for search engines	textarea	Used when a collection has no SEO description. [collection], [shop] and [count] are replaced, e.g. "Shop [collection] at [shop]. Browse [count] products."
Collection description when it has one product or none	textarea
Hide collections with fewer than 2 products from search engines	checkbox	Adds noindex to near-empty collection pages so they don't compete with fuller ones. Default: off

Shipping and returns for Google

Setting	Type	Details
Add shipping and returns to product data	checkbox	Adds the shipping cost, delivery time and return policy to each product's structured data, which Google uses in product results. Fill in the fields below to match your shipping settings and refund policy. Products also ship free from the Cart > Free shipping threshold. Default: off
Ships to (country code)	text	Two letters, such as AU or US. Empty uses the store address country.
Standard shipping cost	number	In your store currency. 0 means free shipping. Default: 0
Free shipping product tag	text	Products with this tag show free shipping. Leave empty if you don't use one.
Processing time, minimum business days	number	Default: 0
Processing time, maximum business days	number	Default: 1
Delivery time, minimum business days	number	Default: 1
Delivery time, maximum business days	number	Default: 5
Return window (days)	number	0 means returns are not accepted. Default: 30
Return postage	select	Options: Paid by the customer, Free returns Default: customer

Social media

Each icon appears only when its network has a link. A link in Shopify Settings > Brand > Social links is used first; these fields fill any network Brand leaves empty and accept any address, for example a campaign page instead of a profile. Leave both empty to hide the icon.

Setting	Type	Details
Facebook	text
Instagram	text
YouTube	text
TikTok	text
X (Twitter)	text
LinkedIn	text
Pinterest	text
Snapchat	text
Tumblr	text
Vimeo	text

Setting	Type	Details
Blog image feed for Pinterest	checkbox	Adds an RSS feed with each article's featured image at /blogs/blog-handle?view=pinterest. Paste that address into Pinterest > Settings > Create Pins in bulk > Auto-publish and Pinterest pins new articles by itself. Articles need a featured image; ones without are left out. Default: off

Licence

Without a licence code the theme runs as Lite: everything works except the features added in the full version (back-to-top button, product tabs, press section, infinite scroll, promo tiles, option values on cards, pre-orders, gift wrapping, Pinterest blog feed, light/dark mode and shipping/returns data for Google). Those settings stay visible here but are skipped for shoppers until a valid code is added.

Setting	Type	Details
Licence code	text	From your account on velosolabs.com, issued for this shop's .myshopify.com address. To keep it when you install a new version, add it instead to Content > Metaobjects as a "velosolabs_licence" entry with the handle tradeline and a "code" field.