Settings Schema Reference

Auto-generate your docs

The settings schema defines global theme settings accessible through the Shopify theme editor. Horizon’s settings are organized into logical groups for easy customization.

Theme Information

Property	Value
Theme Name	Horizon
Version	3.4.0
Author	Shopify
Documentation	Shopify Theme Docs
Support	Shopify Support

Settings Groups

Logo and Favicon

Configure your store’s logo and favicon.

Settings

Setting	Type	Description	Default
`logo`	image_picker	Default logo	-
`logo_inverse`	image_picker	Inverse/light logo for dark backgrounds	-
`logo_height`	range	Desktop logo height	36px
`logo_height_mobile`	range	Mobile logo height	28px
`favicon`	image_picker	Browser favicon	-

Range Values

Logo height: 12-100px (step: 1px)
Visible only when logo is uploaded

Colors

Define color schemes for your theme using a comprehensive color system.

Color Scheme Structure

Each color scheme includes:

Base Colors

Setting	Description	Default
`background`	Background color	#FFFFFF
`foreground_heading`	Heading text color	#000000
`foreground`	Body text color	#000000
`primary`	Primary/link color	#000F9F
`primary_hover`	Primary hover state	#000000
`border`	Border color	#E6E6E6
`shadow`	Shadow color	#000000

Primary Button Colors

Setting	Description	Default
`primary_button_background`	Button background	#000F9F
`primary_button_text`	Button text	#FFFFFF
`primary_button_border`	Button border	#000F9F
`primary_button_hover_background`	Hover background	#000F9F
`primary_button_hover_text`	Hover text	#FFFFFF
`primary_button_hover_border`	Hover border	#000F9F

Secondary Button Colors

Setting	Description	Default
`secondary_button_background`	Button background	#FFFFFF
`secondary_button_text`	Button text	#000000
`secondary_button_border`	Button border	#000000
`secondary_button_hover_background`	Hover background	#FFFFFF
`secondary_button_hover_text`	Hover text	#000000
`secondary_button_hover_border`	Hover border	#000000

Input Colors

Setting	Description	Default
`input_background`	Input background	#FFFFFF
`input_text_color`	Input text	#000000
`input_border_color`	Input border	#000000
`input_hover_background`	Hover background	#F5F5F5

Variant Colors

Setting	Description	Default
`variant_background_color`	Variant background	#FFFFFF
`variant_text_color`	Variant text	#000000
`variant_border_color`	Variant border	#E6E6E6
`variant_hover_background_color`	Hover background	#F5F5F5
`variant_hover_text_color`	Hover text	#000000
`variant_hover_border_color`	Hover border	#E6E6E6

Selected Variant Colors

Setting	Description	Default
`selected_variant_background_color`	Selected background	#000000
`selected_variant_text_color`	Selected text	#FFFFFF
`selected_variant_border_color`	Selected border	#000000
`selected_variant_hover_background_color`	Hover background	#1A1A1A
`selected_variant_hover_text_color`	Hover text	#FFFFFF
`selected_variant_hover_border_color`	Hover border	#1A1A1A

All colors support alpha transparency

Typography

Configure fonts and text styling for your theme.

Font Selections

Setting	Description	Default
`type_body_font`	Body text font	Work Sans (Regular)
`type_subheading_font`	Subheading font	Work Sans (Medium)
`type_heading_font`	Heading font	Anonymous Pro
`type_accent_font`	Accent font	Anonymous Pro

Paragraph Settings

Setting	Options	Default
`type_size_paragraph`	10px - 18px	14px
`type_line_height_paragraph`	Tight, Normal, Loose	Normal

Heading Levels (H1-H6)

Each heading level has these settings:

Setting	Type	Values
Font	select	Heading, Accent, Subheading, Body
Size	select	10px - 184px
Line Height	select	Tight, Normal, Loose
Letter Spacing	select	Tight, Normal, Loose
Text Case	select	Default, Uppercase

Default Sizes

H1: 72px
H2: 48px
H3: 32px
H4: 24px
H5: 18px
H6: 16px

Page Layout

Control overall page width and layout.

Settings

Setting	Options	Default
`page_width`	Narrow, Normal, Wide	Narrow

Animations

Enable or disable various animations and transitions.

Settings

Setting	Type	Description	Default
`page_transition_enabled`	checkbox	Page transitions	true
`transition_to_main_product`	checkbox	Product page transitions	true
`add_to_cart_animation`	checkbox	Add to cart animation	true
`card_hover_effect`	select	Card hover effect	Lift

Card Hover Effects

None
Lift
Scale
Subtle Zoom

Badges

Customize product badges for sale and sold-out items.

Settings

Setting	Type	Default
`badge_position`	select	Top Left
`badge_corner_radius`	range	40px
`badge_sale_color_scheme`	color_scheme	scheme-4
`badge_sold_out_color_scheme`	color_scheme	scheme-5
`badge_font_family`	select	Body
`badge_text_transform`	select	Default

Position Options

Bottom Left
Top Left
Top Right

Buttons

Style primary and secondary buttons.

Primary Button

Setting	Type	Range	Default
`primary_button_border_width`	range	0-4px	0px
`button_border_radius_primary`	range	0-100px	100px
`type_font_button_primary`	select	Body/Accent	Body
`button_text_case_primary`	select	Default/Uppercase	Default

Secondary Button

Setting	Type	Range	Default
`secondary_button_border_width`	range	0-4px	1px
`button_border_radius_secondary`	range	0-100px	100px
`type_font_button_secondary`	select	Body/Accent	Body
`button_text_case_secondary`	select	Default/Uppercase	Default

Pills

Setting	Description	Default
`pills_border_radius`	Border radius for pill elements	40px

Cart

Configure cart functionality and appearance.

Settings

Setting	Type	Description	Default
`cart_type`	select	Page or Drawer	Page
`product_title_case`	select	Title case style	Default
`cart_price_font`	select	Price font	Subheading
`auto_open_cart_drawer`	checkbox	Auto-open drawer on add	false

Features

Setting	Description	Default
`show_cart_note`	Seller note field	false
`cart_note_open_by_default`	Note field open by default	false
`show_add_discount_code`	Discount code field	true
`show_installments`	Show installment options	true
`show_accelerated_checkout_buttons`	Express checkout buttons	true
`empty_cart_button_link`	Empty cart CTA link	/collections/all

Product Media

Setting	Description	Default
`cart_thumbnail_border`	Border style	None
`cart_thumbnail_border_width`	Border width	1px
`cart_thumbnail_border_opacity`	Border opacity	50%
`cart_thumbnail_border_radius`	Corner radius	0px

Drawers

Style drawer/modal elements.

Settings

Setting	Type	Default
`drawer_color_scheme`	color_scheme	scheme-1
`drawer_border`	select	None
`drawer_border_width`	range	1px
`drawer_border_opacity`	range	50%
`drawer_drop_shadow`	checkbox	false

Icons

Configure icon styling.

Settings

Setting	Options	Default
`icon_stroke`	Thin, Default, Heavy	Default

Input Fields

Style form inputs.

Settings

Setting	Type	Default
`input_border_width`	range	1px
`inputs_border_radius`	range	8px
`type_preset`	select	Paragraph

Type Preset Options

Default
Paragraph
H1 - H6

Popovers and Modals

Configure popup styling.

Settings

Setting	Type	Default
`popover_color_scheme`	color_scheme	scheme-1
`popover_border_radius`	range	8px
`popover_border`	select	None
`popover_border_width`	range	1px
`popover_border_opacity`	range	50%
`popover_drop_shadow`	checkbox	false

Accessing Settings in Code

In Liquid Templates

{{ settings.logo_height }}
{{ settings.page_width }}
{{ settings.primary_button_border_radius }}

In CSS

.button {
  border-radius: {{ settings.button_border_radius_primary }}px;
  font-family: {{ settings.type_font_button_primary }};
}

Conditional Logic

{% if settings.page_transition_enabled %}
  <div class="page-transition"></div>
{% endif %}

Best Practices

Use color schemes consistently across sections
Test typography at various sizes before deployment
Keep animations subtle for better UX
Provide clear default values for all settings

Changing settings doesn’t update content, only styling
Some settings may require theme republish to take effect
Always test changes in preview before publishing

Sections Reference

Sections that use theme settings

Customization Guide

Learn how to customize your theme

⌘I

​Theme Information

​Settings Groups

​Settings

​Range Values

​Color Scheme Structure

​Base Colors

​Primary Button Colors

​Secondary Button Colors

​Input Colors

​Variant Colors

​Selected Variant Colors

​Font Selections

​Paragraph Settings

​Heading Levels (H1-H6)

​Default Sizes

​Settings

​Settings

​Card Hover Effects

​Settings

​Position Options

​Primary Button

​Secondary Button

​Pills

​Settings

​Features

​Product Media

​Settings

​Settings

​Settings

​Type Preset Options

​Settings

​Accessing Settings in Code

​In Liquid Templates

​In CSS

​Conditional Logic

​Best Practices

​Related Resources

Sections Reference

Customization Guide

Theme Information

Settings Groups

Settings

Range Values

Color Scheme Structure

Base Colors

Primary Button Colors

Secondary Button Colors

Input Colors

Variant Colors

Selected Variant Colors

Font Selections

Paragraph Settings

Heading Levels (H1-H6)

Default Sizes

Settings

Settings

Card Hover Effects

Settings

Position Options

Primary Button

Secondary Button

Pills

Settings

Features

Product Media

Settings

Settings

Settings

Type Preset Options

Settings

Accessing Settings in Code

In Liquid Templates

In CSS

Conditional Logic

Best Practices

Related Resources