Theme settings reference
Every global setting in the theme — 78 of them across 11 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 23
- Quick view 16
- 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.
Overrides the Soft radius for buttons, variant pills, quantity selectors, purchase options, dropdown triggers, badges, and bordered blocks. Text areas and media thumbnails keep their own corner treatment.
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, featured collections, cart recommendations, related products, 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.
Quick view
The shared product popup used by featured collections and collection product grids. Configure media, product information, purchase options, and style here; enable the action in each section. These controls show existing Shopify data, including selling plans, quantity rules, pickup availability, and payment terms. The Quick view purchase panel renders automatically and has no settings of its own.
Media
Sets the media proportions and desktop modal height, limited by the screen. Longer product information scrolls independently on desktop.
Product information
Uses the optional product reviews rating metafield. Hidden when no rating is available.
Uses the product description from Shopify product data.
Purchase options
Uses native product selling plans. Required subscription options remain visible.
Shown when volume pricing is available for the product and customer.
Uses native pickup availability for the selected variant.
Style
Applies to close, slideshow, playback, and progress controls. Solid backgrounds keep controls clear over product media.
Product variants
Shared picker styles, swatches, and option labels across product cards, product sections, and quick view. Card-location visibility is configured under Product cards.
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. On product cards, text pills also switch to a dropdown when they wrap onto a second row.
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 header menus, footer, breadcrumb, and product links. Links inside body text keep their underline and deepen it on hover.
Global settings and section overrides
Theme settings define the shared design and behavior. Individual sections select a color scheme and can offer spacing, heading size, and layout controls. Configure quick view here for a consistent popup, then enable its card action in the section that displays products.