Theme settings

Overview

Theme settings let you control the look and feel of your online store from one place — typography, colors, layout, buttons, forms, cart, social media links, and more. Because these settings apply to the entire storefront, they are the best place to establish and maintain consistent branding across every page and section.

Colors

Color schemes are reusable color combinations that can be applied to sections throughout your online store. Each scheme defines colors for elements such as text, backgrounds, buttons, borders, icons, and accents, so you can create multiple branded styles and apply them where needed.

Schemes

Select an existing scheme or click Add Scheme to create a new one. Click any swatch within a scheme to update its colors, entering a HEX code or using the color picker. The preview at left of each scheme shows the text (Aa) and button colors it will produce.

Site-wide default

The default color scheme is applied to the whole site as CSS custom properties (for example --paper , --ink , --blue ). Sections don't yet expose their own scheme picker, so every page reads this one scheme. Use Edit scheme to adjust the colors of the selected default.

Customize color schemes

  1. From your Shopify admin, go to Online Store > Themes.
  2. Click Customize next to the theme you want to edit.
  3. Click Theme settings > Colors.
  4. Under Schemes, select an existing scheme or click Add Scheme.
  5. Click any color swatch to update text, background, button, border, and other colors.
  6. Enter a HEX color code or pick a color with the color picker.
  7. Set the Default color scheme that applies site-wide.
  8. Preview the changes to confirm branding consistency, then click Save.

General

Manage essential layout and branding configurations that apply across the storefront.

Side padding

Shared left and right spacing for sections, header, footer, and drawers. Mobile padding applies to screens 768px wide and below. Above 768px, fluid padding scales with the viewport between the mobile and maximum values. Keep the maximum at least as large as the mobile value.

Setting Description
Fluid side padding Padding that scales with the viewport above 768px. Example: 3.4 vw.
Maximum side padding Upper limit for side padding on wide screens. Example: 56px.
Mobile side padding Side padding applied on screens 768px wide and below. Example: 16px.

Favicon

Setting Description
Image Upload a favicon that appears in the browser tab next to your store name. Will be scaled down to 32 × 32px.

Typography

Customize the fonts, weights, sizes, and line heights used throughout your storefront. These settings help maintain consistent readability, hierarchy, and brand identity across all pages. For performance, enable only the font weights your theme actually uses — only enabled weights are loaded.

Display / headings

The display font is used for all display type — hero text, section headings, and product names.

Setting Description
Heading font Font used for all display type (hero, section headings, product names).
Font weights Enable only the weights your theme uses, from Load 100 (Thin) to Load 900 (Black). Example: 400 Regular and 600 Semi-bold enabled.

Heading sizes

Control the size and line height of each heading level (H1–H6).

Setting Description
H1 font size / line height Primary headings. Example: 96px / 107%.
H2 font size / line height Secondary headings. Example: 68px / 113%.
H3 font size / line height Third-level headings. Example: 56px / 110%.
H4 font size / line height Fourth-level headings. Example: 40px / 120%.
H5 font size / line height Fifth-level headings. Example: 28px / 109%.
H6 font size / line height Sixth-level headings. Example: 18px / 122%.

Editorial

The editorial font is used for the manifesto lede, italic emphasis, eyebrows, nav labels, prices, brand-story captions, and technical captions.

Setting Description
Editorial font Secondary font for editorial text. Example: Inter.
Font weights Enable only the weights your theme uses, from Load 100 (Thin) to Load 900 (Black). Example: 400 Regular and 700 Bold enabled.

Text sizes

Control the size and spacing of body text at each scale.

Setting Description
Large font size / line height Larger body text. Example: 16px / 150%.
Medium font size / line height Medium text for product info and content areas. Example: 14px / 150%.
Small font size / line height Smaller content such as labels, helper text, and captions. Example: 12px / 140%.

Motion

Control animated effects across the storefront. Each effect is disabled automatically when a visitor's system prefers reduced motion.

Setting Description
Enable custom cursor Replaces the default cursor with a custom one. Disabled automatically on touch devices and when a visitor prefers reduced motion.
Enable smooth scroll Powers GSAP ScrollSmoother. Disabled automatically when a visitor prefers reduced motion.
Enable grain texture A subtle animated film-grain overlay across every page. Disabled automatically when a visitor prefers reduced motion.

Products

Customize how product variants, swatches, and stock status appear across your storefront.

Setting Description
Variant styles Choose how product variants are displayed. Example: Native swatches.
Color swatch values Define custom color or image swatches for variants. Format values as {ColorName,ColorValue} and separate multiple values with the || separator. ColorValue can be a HEX code (#A9A9A9 or #ABC), rgb(), hsl(), or an image file name. Image file names are ignored when Variant styles is Color, which always shows solid colors. Example: {Dark gray,#A9A9A9}||{Multicolor,image-name.png}. To use an image, upload a PNG whose file name matches the color name with spaces replaced by hyphens (e.g. 'hot-pink.png' for Hot Pink).

Stock status

Controls how product-card stock bars behave based on inventory quantity.

Setting Description
Low stock threshold Whole number, 0 or higher. At or below this quantity, stock bars use the color scheme's Accent contrast. Zero stock shows an empty bar. Example: 5.
In stock threshold Whole number above the low stock threshold. At or above this quantity, bars become full and use the scheme's Accent; between thresholds, bars use Accent wash. Fill represents quantity divided by this target, not an original edition size. Example: 30.

Product tags

Customize the badges shown on products.

Discount tag

Setting Description
Text color Text color for the discount badge. Example: #F1EFE9.
Background color Background color for the discount badge. Example: #D6431F.

Custom tags

Add custom product badges. Format tags as {TagName,BackgroundColor,TextColor} and separate multiple tags with the || separator — for example {New,#000000,#ffffff}||{Trending,#ffffff,#000000}. To display these tags on products, add the matching tags on the product page.

Quick view

Quick View details use the product metafields custom.edition, custom.origin, custom.series, and custom.lead_time. Use single line text definitions; empty values are hidden.

Setting Description
Color scheme Select the color scheme applied to the quick view. Use Edit scheme to adjust its colors.
Background color source Uses a color from the selected scheme for the background. Choose different sources for a readable background and text. Example: Background.
Text color source Uses a color from the selected scheme for text. Choose different sources for a readable background and text. Example: Text.

Cart

Customize how the cart behaves and appears, including the free shipping progress bar.

Setting Description
Cart type Choose Drawer (slides in from the side) or Page (sends shoppers to a full cart page).
Enable order notes Let shoppers add a note to their order.
Enable discount code field Show a discount code field in the cart.
Show product vendor Display the product vendor on cart line items.

Free shipping bar

Setting Description
Show free shipping progress bar Display a progress bar toward the free shipping threshold.
Free shipping threshold Amount, in your store's currency, needed to unlock free shipping (e.g. 200 for €200). Set to 0 to always show shipping as free.
Progress message Message shown while below the threshold. Use ||amount|| where the remaining amount should appear. Example: Spend ||amount|| more for free shipping.
Unlocked message Message shown once free shipping is reached. Example: Free shipping unlocked.

Appearance

Setting Description
Color scheme Select the color scheme applied to the cart.

Authentication pages

Customize the customer account pages — Login, Register, Reset password, and Activate account. Each page shares the same set of heading and appearance controls listed below. In heading text, wrap a word in <em></em> to set it in the editorial italic.

Setting Description
Show shop sign-in button Allows customers to sign in with their Shop account for faster checkout and login. Appears only when Sign in with Shop is enabled for your store.
Heading The page heading text. Supports HTML; wrap a word in <em></em> for editorial italic. Example: Welcome <em>back.</em>
Text size Size of the heading. Example: H3.
Text weight Font weight of the heading. Example: Bold.
Text case Capitalization of the heading. Example: Uppercase.
Heading level HTML heading tag used for SEO. Example: H1.
Heading font Typography style for the heading: Display or Editorial.
Heading color Color style for the heading. Example: Text.
Button style Style for the authentication button. Example: Primary with arrow.
Button case Capitalization of button text. Example: Uppercase.
Color scheme Color scheme applied to the page. Use Edit scheme to adjust its colors.

Available authentication pages

Page Purpose Default heading
Login Customer login page Welcome <em>back.</em>
Register Customer account registration Create an <em>account.</em>
Reset password Password reset page Choose a new <em>password.</em>
Activate account Account activation after registration / email verification Activate your <em>account.</em>

Gift card

Customize the appearance of the gift card page, including the logo, heading, and buttons.

Setting Description
Logo Upload a logo image for the gift card page.
Logo width (desktop) Logo width on desktop. Example: 120px.
Logo width (mobile) Logo width on mobile. Example: 120px.
Heading Gift card heading text. Leave blank to use the default heading. Example: Your gift card.
Text size Size of the heading. Example: H3.
Text weight Font weight of the heading. Example: Normal.
Text case Capitalization of the heading. Example: Capitalize.
Heading level HTML heading tag used for SEO. Example: H1.
Heading font Typography style for the heading. Example: Default.
Heading color Color style for the heading. Example: Default.

Continue shopping button

Setting Description
Button style Style for the continue shopping button. Example: Styled.
Button case Capitalization of button text. Example: Uppercase.
Setting Description
Button style Style for the print button. Example: Secondary.
Button case Capitalization of button text. Example: Uppercase.

Appearance

Setting Description
Color scheme Color scheme applied to the gift card page. Use Edit scheme to adjust its colors.
Background color source Uses a color from the selected scheme for the background. Choose different sources for a readable background and text. Example: Background.
Text color source Uses a color from the selected scheme for text. Choose different sources for a readable background and text. Example: Text.

Social media

Add links to your social media accounts. Enter full links (for example, https://instagram.com/shopify or https://facebook.com/shopify) in the fields provided, then click Save. The following account fields are available:

  • Instagram URL
  • Twitter / X URL — used for the twitter:site social-sharing tag
  • LinkedIn URL
  • Facebook URL
  • YouTube URL
  • Snapchat URL
  • Pinterest URL
  • TikTok URL
  • Tumblr URL
  • Vimeo URL

To add social media links:

  1. Click Theme settings > Social media.
  2. Enter the full link to each account under Accounts.
  3. Click Save.

Custom CSS

Adds custom styles to your entire online store. Enter CSS in the CSS field — for example:

.card {
  border-radius: 30px;
}

Use this to fine-tune styling beyond the other theme settings. Refer to the "Learn more about custom CSS" link in the editor for guidance on supported selectors and limitations.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us