Theme settings reference
Every global setting in the theme — 60 of them across 10 groups. Open these in the theme editor with the gear icon at the bottom of the sidebar. Everything here applies store-wide.
Configure these before you build pages. Every section inherits from them, so setting colors and type first turns a later change into one edit instead of forty.
Jump to a group:
- Typography 4
- Layout 6
- Social media 6
- Colors 1
- Brand 7
- Buttons 1
- Product cards 21
- Product variants 6
- Cart and animations 3
- Motion 5
Typography
Heading and body fonts come from Shopify’s font library. Bold, italic, and bold-italic variants load automatically, so emphasis inside a product description renders properly rather than being synthesized by the browser.
Fonts
Layout
One page-width value drives every section in the theme, along with the page margin and the corner style used by controls, cards, and contained media. Sections meant to be full-bleed ignore the width deliberately.
Sharp uses square corners. Soft rounds controls, cards, contained media, and section surfaces. Full-width media stays square. Custom corner radius settings take priority.
Overrides Corner style for every bordered control and block: buttons, variant pills, quantity selectors, purchase options, dropdown triggers, badges, and blocks such as reassurance rows and sharing. Media thumbnails follow their own shape setting.
Applies to product media thumbnails and takes priority over the corner radius settings. Cornered follows Corner style.
Social media
Links here populate the footer and any section that renders social icons. Leave a network blank to hide its icon rather than linking to an empty profile.
Social accounts
Colors
Color schemes are assigned per section, not configured per section. Change a scheme here and every section using it updates at once. Every background is paired with a foreground so a scheme cannot be configured into an unreadable state.
Brand
Logo, favicon, and the brand details reused across the footer and social sharing.
Favicon
Logo
Brand information
Buttons
The shared button treatment. Accelerated checkout buttons are excluded — Shopify controls their appearance and a theme may not override it.
Choose one hover treatment for theme-authored action buttons.
Applies across the theme. Navigation controls, quantity controls, disabled buttons, and Shopify-branded buttons keep their required interaction styles.
Product cards
These apply to every product card everywhere — collection grids, featured collection rails, search results, and recommendations. The largest single lever you have over how the catalog reads, so set them once here rather than per section.
Design the product card once here. Every section that shows products uses these settings.
Media
Choose a product-card-specific behavior. The global image hover effect still applies to displayed images.
Content
Auto shows Color when available, otherwise the first product option. Size includes options such as Bottle size and Volume.
Variant visibility
Variants are not shown in predictive search so shoppers can scan results quickly. Configure variants on product pages, quick view, collection grids, and search results instead.
Displays star ratings from a connected product reviews app.
Badges
Badges follow a fixed priority: sold out, then sale, then custom, then new. Full product cards show up to two badges on tablet and desktop, and one on mobile. Compact cards show one at every size. A badge that does not fit is not lost — it appears once a higher-priority badge no longer applies.
A sold out product shows this badge on its own, replacing every other badge.
Products published within this many days show a new badge.
Reads the optional custom.card_badge product metafield. Use a short, factual label such as Best seller or Exclusive. Leave it blank on a product to show no custom badge.
Product variants
How variant options render across the theme, including swatches sourced from your variant option values.
Configure shared variant controls used in product cards, product sections, and quick view.
Auto keeps Shopify swatches visible and changes large or long text option groups to dropdowns.
Applies when Shopify product data provides a color or image swatch.
Sold-out variants remain selectable so shoppers can view their media and availability. Combinations that do not exist remain disabled.
Cart and animations
Cart behavior, plus the scroll-reveal toggle for entrance animations.
Cart
Animations
Motion
Transition style and speed apply to every menu, tab, disclosure, drawer, and slideshow. All of it yields to a visitor’s reduced-motion preference automatically, so you do not need to configure anything for that.
Choose one gentle motion style for supported section reveals and slideshow scene changes.
Gives headings and supporting text their own entrance in sections that reveal on scroll.
Applies to menus, disclosures, tabs, search panels, and routine review panels. Reduced-motion preferences override this setting.
Applies to storefront content images. Product-card image settings continue to take priority.
Applies to standalone text links such as footer, breadcrumb, and product links. Header menus follow the menu hover style, and links inside body text keep their underline and deepen it on hover.
What is deliberately absent
There is no per-section spacing control, no per-section font size, and no per-section color picker. These were considered and left out. A theme that lets every section be tuned separately produces stores that look assembled rather than designed, and makes updates far harder to reason about. The global settings above are the intended path.