Settings reference

Labels, defaults and notes on this page match the theme editor exactly.

Theme settings

Open the theme editor and select Theme settings (the gear icon).

Logo

Setting	Type	Default	Notes
Logo image	Image
Logo width	Range, 40–300px	120px
Favicon image	Image		Displayed at 32 x 32px

Colors

Setting	Type	Default	Notes
Color schemes	Color schemes

Typography

Headings

Setting	Type	Default	Notes
Font	Font	Gloock
Font size scale	Range, 80–150%	100%
Letter case	Select: Default, Uppercase	Default

Body

Setting	Type	Default	Notes
Font	Font	Figtree
Font size scale	Range, 90–120%	100%

Layout

Setting	Type	Default	Notes
Page width	Range, 1000–1800px	1440px
Space between template sections	Range, 0–120px	0px	Adds space between sections on every page.
Grid spacing	Range, 4–40px	20px

Buttons and inputs

Setting	Type	Default	Notes
Button corner radius	Range, 0–40px	0px
Use uppercase button labels	Checkbox	On
Input corner radius	Range, 0–20px	0px

Product cards

Cards

Setting	Type	Default	Notes
Image ratio	Select: Adapt to image, Portrait, Square, Landscape	Portrait
Show second image on hover	Checkbox	On
Show vendor	Checkbox	Off
Show quick add button	Checkbox	On

Badges

Setting	Type	Default	Notes
Badge position	Select: Top left, Top right, Bottom left	Top left
Sale badge color scheme	Color scheme	Scheme 4
Sold out badge color scheme	Color scheme	Scheme 3

Animations

Setting	Type	Default	Notes
Enable image zoom on hover	Checkbox	On

Animations are turned off for customers who prefer reduced motion.

Cart

Setting	Type	Default	Notes
Cart type	Select: Drawer, Page	Drawer
Enable order notes	Checkbox	Off
Show vendor	Checkbox	Off

Search behavior

Setting	Type	Default	Notes
Enable search suggestions	Checkbox	On
Show product vendor	Checkbox	Off
Show product price	Checkbox	On

Currency format

Setting	Type	Default	Notes
Show currency codes	Checkbox	On	Cart and checkout prices always show currency codes.

Social media

Social accounts

Setting	Type	Default	Notes
Instagram	Text		https://instagram.com/shopify
TikTok	Text		https://tiktok.com/@shopify
Pinterest	Text		https://pinterest.com/shopify
Facebook	Text		https://facebook.com/shopify
X (Twitter)	Text		https://x.com/shopify
YouTube	Text		https://youtube.com/shopify
Snapchat	Text		https://snapchat.com/add/shopify
Tumblr	Text		https://shopify.tumblr.com
Vimeo	Text		https://vimeo.com/shopify

Sections

Announcement bar

Only in the header area

Setting	Type	Default	Notes
Color scheme	Color scheme	Scheme 3

Announcement block

Setting	Type	Default	Notes
Text	Text	“Welcome to our store”
Link	Link

Blog

Only on: Blog

Setting	Type	Default	Notes
Eyebrow	Text
Heading size	Select: Display, Large, Medium	Display
Alignment	Select: Left, Center	Left
Show tag filter	Checkbox	On

Layout

Setting	Type	Default	Notes
Layout	Select: Grid, Feature the latest post	Feature the latest post
Posts per page	Range, 4–24	10
Columns on desktop	Range, 2–4	3
Columns on mobile	Select: 1 column, 2 columns	1 column
Image ratio	Select: Portrait, Square, Landscape	Portrait

Post card

Setting	Type	Default	Notes
Show date	Checkbox	On
Show author	Checkbox	Off
Show excerpt	Checkbox	On
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	48px
Bottom padding	Range, 0–160px	80px

Blog post

Only on: Blog post

Setting	Type	Default	Notes
Show previous and next post links	Checkbox	On
Comments per page	Range, 5–50	10	Comments show when they are enabled for the blog.
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	48px
Bottom padding	Range, 0–160px	80px

Title block

Setting	Type	Default	Notes
Heading size	Select: Display, Large, Medium	Large
Show date	Checkbox	On
Show author	Checkbox	On

Featured image block

Setting	Type	Default	Notes
Image ratio	Select: Adapt to image, Landscape, Wide	Landscape

Content block

No settings.

Tags block

No settings.

Share block

Setting	Type	Default	Notes
Label	Text	“Share”

Custom Liquid block

Setting	Type	Default	Notes
Custom Liquid	Liquid		Add app snippets or other code to create advanced customizations.

Accepts app blocks.

Blog posts

Any page

Setting	Type	Default	Notes
Eyebrow	Text	“Journal”
Heading	Rich text (one line)	“From the journal”
Heading size	Select: Display, Large, Medium	Large
Blog	Blog
Posts to show	Range, 2–8	3
Show date	Checkbox	On
Show author	Checkbox	Off
Show excerpt	Checkbox	On
Show “View all” link	Checkbox	On

Layout

Setting	Type	Default	Notes
Layout	Select: Grid, Carousel	Grid
Columns on desktop	Range, 2–4	3
Columns on mobile	Select: 1 column, 2 columns	1 column
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Cart

Added by the template

Setting	Type	Default	Notes
Color scheme	Color scheme	Scheme 1
Show dynamic checkout buttons	Checkbox	On	Shows payment methods like Shop Pay, PayPal and Apple Pay, depending on what’s enabled in your store.

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	48px
Bottom padding	Range, 0–160px	80px

Cart drawer

Added by the template

Setting	Type	Default	Notes
Color scheme	Color scheme	Scheme 1

Collection banner

Only on: Collection

Edit the collection title, description and image in your collection settings.

Setting	Type	Default	Notes
Eyebrow	Text
Heading size	Select: Display, Large, Medium	Display
Text alignment	Select: Left, Center	Center
Show collection description	Checkbox	On

Image

Setting	Type	Default	Notes
Show collection image	Checkbox	On	Uses the collection image. 2400 x 1200px recommended.
Image layout	Select: Beside text, Behind text	Beside text
Image height	Select: Small, Medium, Large	Medium
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	40px
Bottom padding	Range, 0–160px	40px

Collection list

Any page

Setting	Type	Default	Notes
Eyebrow	Text	“Shop by category”
Heading	Rich text (one line)	“Collections”
Heading size	Select: Display, Large, Medium	Large
Image ratio	Select: Portrait, Square, Landscape	Portrait
Show product count	Checkbox	Off

Layout

Setting	Type	Default	Notes
Layout	Select: Grid, Carousel	Carousel
Columns on desktop	Range, 2–5	3
Columns on mobile	Select: 1 column, 2 columns	1 column
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Collection block

Setting	Type	Default	Notes
Collection	Collection

Collections list

Only on: Collections list

Setting	Type	Default	Notes
Eyebrow	Text
Heading	Text	“Collections”
Heading size	Select: Display, Large, Medium	Display
Collections per page	Range, 6–48	12
Columns on desktop	Range, 2–4	3
Columns on mobile	Select: 1 column, 2 columns	1 column
Image ratio	Select: Portrait, Square, Landscape	Portrait
Show product count	Checkbox	On
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	48px
Bottom padding	Range, 0–160px	80px

Contact form

Any page

Setting	Type	Default	Notes
Heading	Rich text (one line)	“Get in touch”
Heading size	Select: Display, Large, Medium	Medium
Text	Rich text
Show phone number field	Checkbox	On
Button label	Text	“Send message”
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	40px
Bottom padding	Range, 0–160px	80px

Custom Liquid

Any page

Setting	Type	Default	Notes
Liquid code	Liquid		Add app snippets or other code to create advanced customizations.
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	40px
Bottom padding	Range, 0–160px	40px

Editorial split

Any page

Setting	Type	Default	Notes
Height	Select: Small, Medium, Large, Full screen	Large
Image overlay opacity	Range, 0–80%	25%
Heading size	Select: Display, Large, Medium	Display
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	0px
Bottom padding	Range, 0–160px	0px

Panel block

Setting	Type	Default	Notes
Image	Image		1200 x 1600px recommended.
Eyebrow	Text
Heading	Rich text (one line)	“Rings”
Label	Text	“Shop now”
Link	Link

Email signup

Any page

Setting	Type	Default	Notes
Eyebrow	Text	“Newsletter”
Heading	Rich text (one line)	“Stay in the loop”
Heading size	Select: Display, Large, Medium	Large
Text	Rich text	“New collections, restocks and the occasional private sale. No spam.”

Image

Setting	Type	Default	Notes
Background image	Image		Optional. Text and the form turn white over the image.
Image overlay opacity	Range, 0–80%	25%
Height	Select: Small, Medium, Large, Full screen	Medium
Color scheme	Color scheme	Scheme 3

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	80px
Bottom padding	Range, 0–160px	80px

Featured collection

Any page

Setting	Type	Default	Notes
Eyebrow	Text	“Just in”
Heading	Rich text (one line)	“New arrivals”
Heading size	Select: Display, Large, Medium	Large
Collection	Collection
Products to show	Range, 2–16	8
Show “View all” link	Checkbox	On

Layout

Setting	Type	Default	Notes
Layout	Select: Grid, Carousel	Carousel
Columns on desktop	Range, 2–5	4
Columns on mobile	Select: 1 column, 2 columns	2 columns
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Featured product

Any page except: Product

Setting	Type	Default	Notes
Product	Product
Show vendor	Checkbox	Off
Variant picker	Select: Buttons, Dropdown	Buttons
Swatch shape	Select: Circle, Square	Circle
Show quantity selector	Checkbox	On
Show dynamic checkout buttons	Checkbox	On	Customers see their preferred payment method, like PayPal or Apple Pay.
Media ratio	Select: Adapt to media, Portrait, Square	Portrait
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Accepts app blocks.

Footer

Only in the footer area

Setting	Type	Default	Notes
Color scheme	Color scheme	Scheme 1

Wordmark

Setting	Type	Default	Notes
Show wordmark	Checkbox	On
Wordmark text	Text		Defaults to the store name.

Country/region and language

Setting	Type	Default	Notes
Show country/region selector	Checkbox	On	To add a country/region, go to your Markets settings.
Show language selector	Checkbox	On	To add a language, go to your Languages settings.

Utilities

Setting	Type	Default	Notes
Show Follow on Shop	Checkbox	On	Customers can follow your store on the Shop app. Shop Pay must be enabled.
Show payment icons	Checkbox	On
Show policy links	Checkbox	On	To add store policies, go to your Policies settings.

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	80px
Bottom padding	Range, 0–160px	24px

Menu block

Setting	Type	Default	Notes
Heading	Text	“Quick links”
Menu	Menu	“footer” menu

Text block

Setting	Type	Default	Notes
Heading	Text	“About us”
Text	Rich text	“Share store details, promotions, or brand content with your customers.”

Email signup block

Setting	Type	Default	Notes
Heading	Text	“Subscribe to our emails”
Text	Rich text	“Be the first to know about new collections and exclusive offers.”

Signups add customers to your store’s customer list with accepted marketing.

Social media icons block

Setting	Type	Default	Notes
Heading	Text	“Follow us”

To show social media icons, add your accounts in theme settings under Social media.

Accepts app blocks.

Gift card

Added by the template

Setting	Type	Default	Notes
Color scheme	Color scheme	Scheme 1
Show QR code	Checkbox	On

Header

Only in the header area

Setting	Type	Default	Notes
Desktop logo position	Select: Center, Left	Center
Menu	Menu	“main-menu” menu
Desktop menu type	Select: Dropdown, Mega menu	Dropdown
Sticky header	Select: None, On scroll up, Always	On scroll up
Show separator line	Checkbox	On
Color scheme	Color scheme	Scheme 1
Menu color scheme	Color scheme	Scheme 1

Country/region and language

Setting	Type	Default	Notes
Show country/region selector	Checkbox	On	To add a country/region, go to your Markets settings.
Show language selector	Checkbox	On	To add a language, go to your Languages settings.

Customer account

Setting	Type	Default	Notes
Customer account menu	Menu	“customer-account-main-menu” menu

Hero

Any page

Setting	Type	Default	Notes
Image	Image		2400 x 1350px recommended.
Mobile image	Image		Optional. Shows on small screens. 750 x 1100px recommended.
Image overlay opacity	Range, 0–80%	30%
Height	Select: Small, Medium, Large, Full screen	Full screen
Content position	Select: Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right	Middle center
Color scheme	Color scheme	Scheme 1	Applies when no image is selected. Text over images is white.

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	0px
Bottom padding	Range, 0–160px	0px

Blocks: Heading, Text, Button, Custom Liquid (see Theme blocks).

Accepts app blocks.

Image with text

Any page

Setting	Type	Default	Notes
Image	Image
Image position	Select: Left, Right	Left
Image ratio	Select: Adapt to image, Portrait, Square, Landscape	Portrait
Content alignment	Select: Top, Middle, Bottom	Middle
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Blocks: Heading, Text, Button, Custom Liquid (see Theme blocks).

Accepts app blocks.

Logo list

Any page

Setting	Type	Default	Notes
Eyebrow	Text
Heading	Rich text (one line)	“As featured in”
Heading size	Select: Display, Large, Medium	Large
Logo height	Select: Small, Medium, Large	Medium
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	48px
Bottom padding	Range, 0–160px	48px

Logo block

Setting	Type	Default	Notes
Logo	Image		Transparent PNG or SVG works best. Uses the image alt text.
Link	Link

Multicolumn

Any page

Setting	Type	Default	Notes
Eyebrow	Text	“Our promise”
Heading	Rich text (one line)	“Made with care”
Heading size	Select: Display, Large, Medium	Large
Image ratio	Select: Portrait, Square, Landscape	Square
Columns on desktop	Range, 2–4	3
Alignment	Select: Left, Center	Left
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Column block

Setting	Type	Default	Notes
Image	Image
Title	Text	“Recycled gold”
Text	Rich text	“Explain a promise, a material or a service in a sentence or two.”
Link label	Text
Link	Link

Page

Only on: Page

Setting	Type	Default	Notes
Heading size	Select: Display, Large, Medium	Display
Alignment	Select: Left, Center	Center
Content width	Select: Narrow, Wide	Narrow
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	48px
Bottom padding	Range, 0–160px	80px

Page not found

Only on: Page not found

Setting	Type	Default	Notes
Heading size	Select: Display, Large, Medium	Display
Show search	Checkbox	On
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	96px
Bottom padding	Range, 0–160px	120px

Password

Added by the template

Setting	Type	Default	Notes
Color scheme	Color scheme	Scheme 2
Show email signup	Checkbox	On
Heading	Text	“Be the first to know”

Product grid

Only on: Collection

Setting	Type	Default	Notes
Products per page	Range, 8–48	16
Columns on desktop	Range, 2–5	4
Columns on mobile	Select: 1 column, 2 columns	2 columns

Filtering and sorting

Setting	Type	Default	Notes
Enable filtering	Checkbox	On	Customize filters with the Search and Discovery app.
Enable sorting	Checkbox	On
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	16px
Bottom padding	Range, 0–160px	80px

Product information

Added by the template

Setting	Type	Default	Notes
Color scheme	Color scheme	Scheme 1

Media

Setting	Type	Default	Notes
Desktop layout	Select: Stacked, Two-column grid	Stacked
Image ratio	Select: Adapt to image, Portrait, Square	Adapt to image
Enable full-screen image view	Checkbox	On
Enable sticky product information on desktop	Checkbox	On

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	24px
Bottom padding	Range, 0–160px	64px

Vendor block

No settings.

Title block

No settings.

Price block

Setting	Type	Default	Notes
Show Shop Pay Installments	Checkbox	On	Shows when Shop Pay Installments is available in your store.

Variant picker block

Setting	Type	Default	Notes
Style	Select: Buttons, Dropdown	Buttons
Swatch shape	Select: Circle, Square	Circle	Swatches show for options with color or image values set up in your product options.

Quantity selector block

No settings.

Buy buttons block

Setting	Type	Default	Notes
Show dynamic checkout buttons	Checkbox	On	Shows payment methods like Shop Pay, PayPal and Apple Pay, depending on what’s enabled in your store.
Show recipient form for gift cards	Checkbox	On	Customers can send gift cards to a recipient with a personal message.

Pickup availability block

No settings.

SKU block

No settings.

Description block

No settings.

Text block

Setting	Type	Default	Notes
Text	Rich text (one line)	“Text block”
Text style	Select: Body, Subtitle, Uppercase	Body

Collapsible row block

Setting	Type	Default	Notes
Heading	Text	“Collapsible row”
Row content	Rich text
Row content from page	Page
Show row open by default	Checkbox	Off

Share block

Setting	Type	Default	Notes
Button label	Text	“Share”

Complementary products block

To select complementary products, add the Search and Discovery app.

Setting	Type	Default	Notes
Heading	Text	“Pairs well with”
Maximum products to show	Range, 1–10	3

Custom Liquid block

Setting	Type	Default	Notes
Custom Liquid	Liquid		Add app snippets or other code to create advanced customizations.

Accepts app blocks.

Product recommendations

Only on: Product

Recommendations improve over time based on order and product data.

Setting	Type	Default	Notes
Recommendation type	Select: Related products, Complementary products	Related products
Eyebrow	Text	“Related items”
Heading	Text	“You may also like”
Heading size	Select: Display, Large, Medium	Large
Maximum products to show	Range, 2–10	4
Columns on desktop	Range, 2–5	4
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Rich text

Any page

Setting	Type	Default	Notes
Alignment	Select: Left, Center	Center
Content width	Select: Narrow, Wide	Narrow
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Blocks: Heading, Text, Button, Custom Liquid (see Theme blocks).

Accepts app blocks.

Search results

Only on: Search

Setting	Type	Default	Notes
Heading size	Select: Display, Large, Medium	Large
Results per page	Range, 8–48	16
Columns on desktop	Range, 2–5	4
Columns on mobile	Select: 1 column, 2 columns	2 columns

Filtering and sorting

Setting	Type	Default	Notes
Enable filtering	Checkbox	On	Filters show for product results. Customize them with the Search and Discovery app.
Enable sorting	Checkbox	On
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	48px
Bottom padding	Range, 0–160px	80px

Slideshow

Any page

Setting	Type	Default	Notes
Height	Select: Small, Medium, Large, Full screen	Large
Auto-rotate slides	Checkbox	Off	A pause button shows when slides rotate.
Change slides every	Range, 4–10s	6s
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	0px
Bottom padding	Range, 0–160px	0px

Blocks: Slide (see Theme blocks).

Testimonials

Any page

Setting	Type	Default	Notes
Eyebrow	Text	“Kind words”
Heading	Rich text (one line)
Heading size	Select: Display, Large, Medium	Large
Color scheme	Color scheme	Scheme 2

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	80px
Bottom padding	Range, 0–160px	80px

Testimonial block

Setting	Type	Default	Notes
Quote	Rich text (one line)	“Share a review or a press quote that captures how customers feel about your pieces.”
Author	Text	“Customer name”
Detail	Text		For example a location or publication.

Video

Any page

Setting	Type	Default	Notes
Eyebrow	Text
Heading	Rich text (one line)	“Behind the bench”
Heading size	Select: Display, Large, Medium	Large
Video	Video		Upload a video to play it with the theme’s own controls.
YouTube or Vimeo URL	Video URL		Used when no video is uploaded.
Video description	Text		Describes the video for screen readers.
Cover image	Image		Shows before the video plays.
Image ratio	Select: Landscape (16:9), Classic (4:3), Square	Landscape (16:9)
Full width	Checkbox	Off
Color scheme	Color scheme	Scheme 1

Section padding

Setting	Type	Default	Notes
Top padding	Range, 0–160px	64px
Bottom padding	Range, 0–160px	64px

Theme blocks

These blocks are shared by the hero, slideshow, rich text and image with text sections.

Slide (slideshow only)

Setting	Type	Default	Notes
Image	Image		2400 x 1350px recommended.
Mobile image	Image		Optional. Shows on small screens. 750 x 1100px recommended.
Image overlay opacity	Range, 0–80%	30%
Content position	Select: Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right	Bottom left
Color scheme	Color scheme	Scheme 1	Applies when no image is selected. Text over images is white.

Button

Setting	Type	Default	Notes
Label	Text	“Shop now”
Link	Link
Style	Select: Primary, Secondary, Link	Primary

Custom Liquid

Setting	Type	Default	Notes
Liquid code	Liquid		Add app snippets or other code to create advanced customizations.

Heading

Setting	Type	Default	Notes
Eyebrow	Text
Heading	Rich text (one line)	“Made to be worn every day”
Heading size	Select: Display, Large, Medium	Display

Text

Setting	Type	Default	Notes
Text	Rich text	“Share what makes your pieces special: the materials, the makers, the way they wear.”
Text size	Select: Small, Body, Large	Body