Metonia Docs

Settings reference

Every setting in Metonia 1.0.0, generated from the theme's own settings files so the names match the theme editor exactly.

Theme settings

Open these from the gear icon in the theme editor.

Typography

SettingTypeNotes
Heading
Heading fontFont
Font size scaleSlider80–150%
Letter spacingSlider-8–20
Line height scaleSlider80–140%
Body
Body fontFont
Font size scaleSlider80–140%
Letter spacingSlider-2–20
Line height scaleSlider100–180%
Announcement bar
Font size scaleSlider80–140%
Navigation
Font size scaleSlider80–140%
Menu item spacingSliderAffects only the first level menu items.
8–40px
Make navigation uppercaseOn/off
Product card
Product title size scaleSlider70–160%
Product title line height scaleSlider80–160%
Make product title uppercaseOn/off
Enable quick viewOn/offShows a Select options drawer from product cards. Turn off to hide it.
New badge durationSliderShows a New badge for this many days after publish. Set to 0 to hide it. A custom label uses the product metafield custom.badge (single line text).
0–90
Show floating product cardOn/offShows the product bar when Add to cart scrolls out of view. Turn off to hide it.
Buttons
Letter spacingSlider0–40
Make buttons uppercaseOn/off
Font size scaleSlider80–150%

Layout

SettingTypeNotes
Page widthChoiceNarrow · Wide
Page marginSlider10–100px
Mobile page marginSliderSide inset on screens under 750px. Full-bleed galleries and the homepage slideshow ignore it.
10–100px

Colors

SettingTypeNotes
General
Page backgroundColorPaints the page canvas behind every section.
Body textColorDefault ink for body copy, navigation, and prices.
PrimaryColorAccent used for highlights and focus.
Lines and bordersColor
Input bordersColor
Muted textColorSecondary copy: excerpts, captions, and helper text.
Input corner radiusSlider0–10px
Announcement bar
TextColor
BackgroundColor
Header
BackgroundColor
TextColor
LinksColor
Link hoverColor
IconsColor
Lines and bordersColor
Buttons
Solid button backgroundColor
Solid button labelColor
Outline button labelColor
Products
PriceColor
Discounted priceColorUsed when a compare-at price is set.
Star ratingsColor
DotsColorPagination dots on light backgrounds. Slideshow dots stay white so they remain visible on photos.
Product inventory level
In stockColor
Low stockColor
Footer
TextColor
LinkColor
Link hoverColor
BorderColor
BackgroundColor

Social media

SettingTypeNotes
InstagramText
FacebookText
PinterestText
TikTokText
YouTubeText
XText
ThreadsText
SnapchatText
TumblrText
VimeoText
Social sharing imageImageUsed when a page has no product, article, or collection image.

Favicon

SettingTypeNotes
FaviconImage

Sections

Sections marked Add section can be added to any compatible page. The others are part of a specific template or of the header and footer.

Announcement barheader group

SettingTypeNotes
EnableOn/off
TextText
LinkLink

BlogTemplate section

SettingTypeNotes
TextText

Blog postsAdd section

SettingTypeNotes
HeadingText
TextText
BlogBlog
Posts to showSlider2–8

CartTemplate section

SettingTypeNotes
Order notesOn/off

Category linksAdd section

SettingTypeNotes
MenuMenu

Block: Link

SettingTypeNotes
HeadingText
CollectionCollection
LinkLink

Collapsible contentAdd section

SettingTypeNotes
HeadingText
TextRich text
AlignmentChoiceLeft · Center · Right

Block: Row

SettingTypeNotes
HeadingText
ContentRich text

CollectionTemplate section

SettingTypeNotes
Subcategory menuMenu
Products per pageSlider8–36
Show vendorOn/off
Fallback promo tile
Promo headingTextUsed only when no Promo tile blocks are added. Needs a heading and an image.
Promo textText
Promo buttonText
Promo linkLink
Promo imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
SEO text
SEO headingText
SEO textRich text

Block: Promo tile (up to 4)

SettingTypeNotes
Show after productSlider1 places the tile after the first product. Only the first page of the collection shows tiles.
1–36
Promo imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
Promo headingText
Promo textText
Promo buttonText
Promo linkLink

Collection listAdd section

SettingTypeNotes
HeadingText
ColumnsSlider2–5
Show imagesOn/off

Block: Collection

SettingTypeNotes
CollectionCollection
Desktop imageImage
HeadingText

Collection tabsAdd section

SettingTypeNotes
HeadingText
TextText
Products to showSlider2–8

Block: Tab

SettingTypeNotes
HeadingText
CollectionCollection

ContactAdd section

SettingTypeNotes
HeadingText
TextText
AlignmentChoiceLeft · Center · Right

Countdown bannerAdd section

SettingTypeNotes
EyebrowText
HeadingText
TextText
Solid button labelText
Button linkLink
End dateTextReal promotion end date in ISO format, for example 2026-12-31T23:59:59. Do not use a repeating fake timer.

Custom LiquidAdd section

SettingTypeNotes
Custom LiquidLiquid

Custom sectionAdd section

SettingTypeNotes
BackgroundImage

EditorialAdd section

SettingTypeNotes
EyebrowText
HeadingText
TextText
Solid button labelText
Button linkLink
Desktop imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
Image positionChoiceLeft · Right
SettingTypeNotes
EyebrowText
HeadingText
ContentText
AlignmentChoiceLeft · Center
Card sizeChoiceStandard · Compact
CollectionCollection
ColumnsSlider2–4
Products to showSlider2–12

Block: Custom Liquid

SettingTypeNotes
Custom LiquidLiquid
SettingTypeNotes
HeadingText
ProductProduct

Block: Custom Liquid

SettingTypeNotes
Custom LiquidLiquid
SettingTypeNotes
LogoImageShown on the dark footer background. When empty, the store name is used.
TaglineText
Show payment iconsOn/off
Country / region selectorOn/off
Language selectorOn/off

Block: Footer menu

SettingTypeNotes
HeadingText
MenuMenu

Block: Newsletter (up to 1)

SettingTypeNotes
HeadingText
TextText
SettingTypeNotes
EyebrowText
HeadingText
TextText
ColumnsSlider2–4

Block: Image

SettingTypeNotes
Desktop imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
HeadingText
TextText
Solid button labelText
LinkLink

Headerheader group

SettingTypeNotes
LogoChoiceText logo uses Header text. On the transparent homepage header it uses Transparent text and icons. Image logos are not recolored.
Image · Text
Logo textTextLeave empty to use the store name.
LogoImage
Mobile logoImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
MenuMenu
Customer account menuMenu
Show account icon on mobileOn/offOff by default. Account stays in the mobile menu. Turn on to show the account icon in the header below 980px.
Transparent header
Transparent over the homepage heroOn/offHomepage only. The bar sits on the slideshow until that section scrolls past, then uses the sticky colors.
Transparent text and iconsColor
Logo while transparentImageOptional light logo for the transparent state. Leave empty to keep the main logo.
Sticky header
Keep the header visible while scrollingOn/offPins the header above the page. On the homepage it stays on top of the slideshow instead of disappearing. Header colors are in Theme settings, Colors, Header.
Country / region selectorOn/off
Language selectorOn/off

Block: Mega menu

SettingTypeNotes
Menu itemTextExact title of the top-level menu item that should open this mega menu.
Desktop imageImage
HeadingText
LinkLink

HeroAdd section

SettingTypeNotes
EyebrowText
HeadingText
TextText
Solid button labelText
Button linkLink
Desktop imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.

Image overlayAdd section

SettingTypeNotes
Desktop imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
EyebrowText
HeadingText
TextText
Solid button labelText
Button linkLink

Image with textAdd section

SettingTypeNotes
Desktop imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
Image positionChoiceLeft · Right
EyebrowText
HeadingText
TextRich text
Color schemeChoiceDefault · Dark
Solid button labelText
Button linkLink

MulticolumnAdd section

SettingTypeNotes
HeadingText
ColumnsSlider2–4

Block: Column

SettingTypeNotes
Desktop imageImage
HeadingText
TextRich text

NewsletterAdd section

SettingTypeNotes
HeadingText
TextText

PageTemplate section

SettingTypeNotes
Show headingOn/off
AlignmentChoiceLeft · Center · Right
Page widthChoiceNarrow · Reading · Wide
PaddingSlider2–8rem

PasswordTemplate section

SettingTypeNotes
Show email signupOn/off

ProductTemplate section

SettingTypeNotes
Full-width gallery on mobileOn/offStretches the product gallery to the screen edges on small screens. Turn this off to keep the page margin.
Floating product cardOn/offSection switch for the floating product card. Theme settings also has a global switch.

Block: Custom Liquid

SettingTypeNotes
Custom LiquidLiquid

Block: Vendor (up to 1)

No block settings.

Block: Title (up to 1)

No block settings.

Block: Price (up to 1)

No block settings.

Block: Variant picker (up to 1)

SettingTypeNotes
Sizing guide labelText
Sizing guide pagePage
Show sizing guide on products without a size optionOn/offBy default the link only appears next to Size or Ring size options.

Block: Quantity (up to 1)

No block settings.

Block: Buy buttons (up to 1)

SettingTypeNotes
Dynamic checkout buttonsOn/off

Block: Description (up to 1)

No block settings.

Block: Collapsible row

SettingTypeNotes
HeadingText
ContentRich text
PagePage
Open by defaultOn/off

Block: Product information

SettingTypeNotes
Each block is one tab. You can add, remove, and reorder tabs. The first filled source is used: Custom Liquid, then the product metafield, then the page, then Content.
HeadingText
IconChoiceAutomatic · Box · Drop · Cube · None
ContentRich textWrite the tab text here, or use the dynamic source icon to connect a compatible product metafield.
PagePageOptional shared page. Used when Custom Liquid and the metafield are empty.
Product metafieldTextOptional. Format: namespace.key, for example custom.materials. Works with single-line, multi-line, and rich text metafields.
Custom LiquidLiquidOptional. Overrides the other sources when filled. You can output a metafield with the metafield_tag filter.

Block: Share (up to 1)

No block settings.

Block: Pickup availability (up to 1)

No block settings.

Recently viewedAdd section

SettingTypeNotes
HeadingText
ContentText
Products to showSlider2–8

RelatedAdd section

SettingTypeNotes
HeadingText
Products to showSlider2–8
Recommendation typeChoiceRelated products · Complementary products

Rich textAdd section

SettingTypeNotes
EyebrowText
HeadingText
TextRich text
Solid button labelText
Button linkLink
Button styleChoiceSolid · Outline
AlignmentChoiceLeft · Center · Right

Scrolling textAdd section

SettingTypeNotes
TextText
SpeedSlider10–60s

Search drawerTemplate section

SettingTypeNotes
Quick linksMenu
Trending collectionCollection

Shop the lookAdd section

SettingTypeNotes
Desktop imageImage
Mobile imageImageOptional. Shown on screens under 750px. If empty, the desktop image is used.
HeadingText

Block: Product

SettingTypeNotes
ProductProduct
Horizontal positionSlider5–95%
Vertical positionSlider5–95%
Different pin position on mobileOn/off
Mobile horizontal positionSlider5–95%
Mobile vertical positionSlider5–95%

SlideshowAdd section

SettingTypeNotes
LayoutChoiceVertical snap · Fade
OverlaySlider0–80%
Mobile behaviorChoiceVertical layout scrolls through slides on every screen. The next slide moves up with the page, then the rest of the page follows.
Swipe · Fade
Show video controls on mobileOn/offOff by default. On phones the mobile image is used, or the desktop image if that is empty, and the video stays paused. Turn this on to play the video on phones instead.
AutoplayOn/off
SpeedSlider3–12s

Block: Slide

SettingTypeNotes
Desktop imageImageShown on screens 750px and wider. If this is set, the video does not play on desktop.
Mobile imageImageShown only under 750px. Replaces the desktop image and the video on phones. If empty, the desktop image is used.
VideoVideoPlays on desktop only when no desktop image is set. On phones it stays hidden unless “Show video controls on mobile” is on.
EyebrowText
HeadingText
TextText
Solid button labelText
Button linkLink
AlignmentChoiceLeft · Center · Right

SpacerAdd section

SettingTypeNotes
Desktop heightSlider8–160px
Mobile heightSlider8–120px

TestimonialsAdd section

No section settings.

Block: Quote

SettingTypeNotes
QuoteText
AuthorText

Text with iconsAdd section

No section settings.

Block: Item

SettingTypeNotes
IconText
HeadingText
TextText

TimelineAdd section

SettingTypeNotes
HeadingText

Block: Item

SettingTypeNotes
Desktop imageImage
HeadingText
TextText