XenonTheme guide Get support

Settings reference

Every setting in Xenon, named as the theme editor names it. The chapters of this guide explain how to use them.

Theme settings

In the theme editor, open Theme settings (the gear icon).

Logo and favicon

Setting Choices Default Notes
Logo An image
Logo width 60–300px 140px
Logo width on mobile 60–200px 110px
Favicon An image Shown at 32 x 32px

Colors

The color schemes. Each sets a background, text, button, button label and border color.

Status colors

Used for stock labels and sale prices on light color schemes

Setting Choices Default Notes
In stock A color #15803D
Supplier stock A color #15803D
Unavailable A color #B91C1C
Sale price A color #B91C1C

Typography

Setting Choices Default Notes
Heading font A font Plus Jakarta Sans 700
Body font A font Plus Jakarta Sans 400

Layout

Setting Choices Default Notes
Page width 1000–1600px 1440px
Corner radius 0–16px 6px Applies to buttons and form fields
Setting Choices Default Notes
Collections to skip Text featured, new-arrivals, best-sellers A product never shows a collection whose handle contains one of these words as its breadcrumb. Separate with commas. The all and frontpage collections are always skipped.
Shorten collection titles at a dash On or off Off For example "Laptop batteries – Restore your runtime" shows as "Laptop batteries"

Store details

Used in the footer, on the contact page and in your store's structured data. Leave a field blank to use the matching detail from Settings, Store details.

Setting Choices Default Notes
Trading name Text
Legal name Text Your company's registered name, for search engines
Phone Text
Email Text
Address Text
Opening hours Text
WhatsApp number Text Include the country code, for example +1 212 555 0100. Used by the footer and the WhatsApp button.

Social media

Each link you add shows as an icon in the footer's social media icons block.

Setting Choices Default Notes
Facebook A link
Instagram A link
X A link
YouTube A link
TikTok A link
Pinterest A link
LinkedIn A link

Product cards

Setting Choices Default Notes
Image ratio Square, Portrait, Natural Square
Image fit Show whole image, Fill frame Show whole image
Show second image on hover On or off Off
Show vendor On or off Off
Show product summary On or off Off A short line under the title, from a product metafield, such as the processor, memory and storage
Summary metafield Text custom.summary The metafield's namespace and key, separated by a dot
Show part number On or off On
Show condition badge On or off On
Show stock label On or off On
Show add to cart button On or off On Products with options show a link to choose them instead
Open product options in a quick view On or off On Products with options open in a window on the same page, instead of their product page. Needs Show add to cart button.

Part numbers

Setting Choices Default Notes
Part number source SKU, Metafield SKU
Part number metafield Text custom.part_number The metafield's namespace and key, separated by a dot

Product condition

Setting Choices Default Notes
Condition source Tags, Metafield Tags
Condition tags Text Demo, Refurbished, Used Separate tags with commas. The first tag that matches shows as the badge, spelled as you write it here.
Condition metafield Text custom.condition The metafield's namespace and key, separated by a dot
Hide badge for new products On or off On

Stock source

Setting Choices Default Notes
Supplier stock tags Text supplier-stock Products with any of these tags show the supplier stock label. Separate tags with commas.
In stock label Text Leave blank to use the default text
Supplier stock label Text Leave blank to use the default text
Unavailable label Text Leave blank to use the default text
Request page A page Unavailable products link to this page so shoppers can ask about them

Dispatch times

Shown on product pages beside the stock label, for example "1 to 4 business days". Leave blank to hide.

Setting Choices Default Notes
Own stock Text
Supplier stock Text
Products that don't need shipping Text For example license keys sent by email
Dispatch time metafield Text custom.dispatch_time A product's own dispatch time, which replaces the times above. Namespace and key, like custom.dispatch_time.

Cart

Setting Choices Default Notes
Cart type Drawer, Page Drawer
Free shipping threshold A number 0 In your store's currency. Converted for shoppers who pay in another currency. Set to 0 to hide the bar.
Show order note On or off On
Show accelerated checkout buttons in the drawer On or off On Such as Shop Pay, when set up in your payment settings
Setting Choices Default Notes
Enable predictive search On or off On Shows products, collections and suggested searches as shoppers type in the search field
Show vendor in results On or off Off
Show price in results On or off On
Search products only On or off Off Leaves pages and blog posts out of search results and suggestions

WhatsApp

Setting Choices Default Notes
Show WhatsApp button On or off Off Uses the WhatsApp number in Store details. The button shows on every page.
Button label Text Leave blank to use the default text
Message Text Typed in for the shopper, who can change it before sending. Leave blank to use the default text.
Add the product to the message on product pages On or off On
Position Right, Left Right
Color scheme A color scheme Scheme 4

These sit at the top and bottom of every page.

Announcement bar

Setting Choices Default Notes
Color scheme A color scheme Scheme 3
Rotate messages On or off On Messages pause while a shopper hovers over or focuses them
Seconds per message 3–10s 5s
Top bar menu A menu The "footer" menu Shown on desktop, beside the announcements

Announcement block

Setting Choices Default Notes
Text Text "Welcome to our store"
Link A link
Setting Choices Default Notes
Color scheme A color scheme Scheme 3
Copyright text Text Leave blank to show the year and your store name
Show payment icons On or off On
Show Follow on Shop On or off On Shows when Shop Pay is set up in your store

Country/region and language

Setting Choices Default Notes
Show country/region selector On or off On
Show language selector On or off On

Brand block

Setting Choices Default Notes
Show logo On or off On
Logo An image Leave blank to use the logo from theme settings
Logo width 60–300px 160px
Text Formatted text
Show store details On or off On Shows the address, phone, email, WhatsApp number and opening hours from Theme settings > Store details
Setting Choices Default Notes
Heading Text
Footer menu A menu The "footer" menu

Text block

Setting Choices Default Notes
Heading Text
Text Formatted text

Social media icons block

Setting Choices Default Notes
Heading Text Leave blank to use the default text

Newsletter block

Setting Choices Default Notes
Heading Text
Text Formatted text
Button label Text Leave blank to use the default text
Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Sticky header None, On scroll up, Always On scroll up
Setting Choices Default Notes
Main menu A menu The "main-menu" menu
Main menu style Mega menu, Dropdown Mega menu
Main menu color scheme A color scheme Scheme 4
Secondary menu A menu The "footer" menu Shown in the mobile navigation, below the main menu
Customer account menu A menu The "customer-account-main-menu" menu Links in the menu that opens from the account icon

Search

Setting Choices Default Notes
Show search field on desktop On or off On
Search placeholder Text Leave blank to use the default text

Country/region and language

Shown in the mobile navigation when your store sells in more than one country/region or language

Setting Choices Default Notes
Show country/region selector On or off On
Show language selector On or off On

Mega menu image block

Setting Choices Default Notes
Main menu item Text Enter the name of a top-level item exactly as it appears in the main menu. The image shows in that item's mega menu.
Image An image
Heading Text
Link A link

Page templates

Each template has one main section, which can't be removed. Its settings and blocks shape that kind of page.

Blog post

The main section of the blog post template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off On
Show featured image On or off On
Show date On or off On
Show author On or off On
Show tags On or off On
Setting Choices Default Notes
Products metafield Text custom.related_products A product list metafield on the blog post. Posts with the metafield empty show no products.
Heading Text Leave blank to use the default text
Text Text
Products to show 2–8 4

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Blog posts

The main section of the blog template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off On
Eyebrow Text
Introduction Formatted text
Posts per page 3–24 9
Columns on desktop 2–4 3
Show featured image On or off On
Show date On or off On
Show author On or off On
Show excerpt On or off On

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Cart

The main section of the cart template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off Off
Show payment icons On or off On

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Collection list

The main section of the collection list template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off On
Columns on desktop 2–6 4
Columns on mobile 1 column, 2 columns 2 columns
Show product count On or off Off

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Collection products

The main section of the collection template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off On
Show collection image On or off On
Show collection description On or off On
Products per page 8–50 24
Columns on desktop 2–6 4
Columns on mobile 1 column, 2 columns 2 columns
Show product count On or off On
Enable sorting On or off On
Enable filtering On or off On Choose which filters show in the Search and Discovery app
Filter layout on desktop Sidebar, Drawer Sidebar On mobile, filters always open in a drawer

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Contact form

The main section of the contact page template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off On
Eyebrow Text
Heading Text Leave blank to use the page's title
Text Formatted text Leave blank to use the page's content

Form

Setting Choices Default Notes
Heading Text "Send us a message"
Text Text "Choose a request type so your message reaches the right person."
Show reference field On or off On
Reference field label Text Leave blank to use the default text

Guidance

Setting Choices Default Notes
Heading Text Leave blank to use the default text
Guidance Formatted text For part requests: your model, the part number, and photos if you can. For an RMA or a return: your order number, the part number and what went wrong. For tech support: your model, the symptoms and any error messages. Shown beside the form until a request type with its own guidance is chosen
Color scheme A color scheme Scheme 5

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Request type block

Setting Choices Default Notes
Label Text "General question" Shown in the list and sent with the message
Link handle Text For example part-request. A link to this page ending in ?type=part-request chooses this type.
Helper text Text A short line under the list when this type is chosen
Guidance Formatted text Replaces the general guidance when this type is chosen

Page

The main section of the page template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off Off
Show page title On or off On
Content width Normal, Narrow Normal

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Page not found

The main section of the page not found template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1

Password

The main section of the password page.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Heading Text Leave blank to use the default text
Show email signup On or off On Signups are saved to Customers, with email marketing consent

Product information

The main section of the product template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off On

Media

Setting Choices Default Notes
Media layout Thumbnails, Stacked Thumbnails
Media width on desktop Small, Medium, Large Medium
Enable image zoom On or off On
Loop videos On or off Off
Keep product information in view while scrolling On or off On

Spacing

Setting Choices Default Notes
Top padding 0–96px 32px
Bottom padding 0–96px 48px

Apps: blocks from apps you install can go in this section.

Title block

No settings.

Part number block

Setting Choices Default Notes
Show label On or off On

Condition badge block

No settings.

Price block

No settings.

Stock source block

Setting Choices Default Notes
Show dispatch time On or off On
Show a way to ask about unavailable products On or off On Links unavailable products to the request page in Theme settings > Stock source

Variant picker block

Setting Choices Default Notes
Style Buttons, Dropdown Buttons
Show swatches On or off On

Quantity selector block

Setting Choices Default Notes
Show label On or off On

Buy buttons block

Setting Choices Default Notes
Show dynamic checkout buttons On or off On Lets shoppers check out straight away with a saved payment method
Show Shop Pay Installments On or off On
Show gift card recipient form On or off On

Description block

Setting Choices Default Notes
Heading Text
Fold long sections On or off On
Headings to fold Text spec, in the box Separate with commas. A section folds when a word in its heading starts with one of these, or its heading contains a phrase that has spaces.
Fold sections longer than 0–3000 700 Shorter sections stay open, since they're quicker to read than to open

Pickup availability block

No settings.

Payment icons block

Setting Choices Default Notes
Heading Text Leave blank to use the default text

Callout block

Setting Choices Default Notes
Eyebrow Text "Buying guide"
Heading Text "Check compatibility before you order"
Guides metafield Text custom.related_guides A product metafield listing blog posts. Up to 3 show as links. Namespace and key, like custom.related_guides.
Link label Text
Link A link
Color scheme A color scheme Scheme 5

Share block

Setting Choices Default Notes
Show Facebook On or off On
Show X On or off On
Show WhatsApp On or off On
Show copy link On or off On

Collapsible tab block

Setting Choices Default Notes
Heading Text "Shipping"
Icon None, Truck, Shield, Return, Information None
Content Formatted text
Page A page Shown below the content, so one page can hold your shipping or returns policy for every product

Specifications block

Setting Choices Default Notes
Heading Text Leave blank to use the default text
Metafield Text custom.specifications A JSON metafield, or text with one "Label: value" per line. Namespace and key, like custom.specifications.

Compatibility block

Setting Choices Default Notes
Heading Text Leave blank to use the default text
Models metafield Text custom.compatible_models A list metafield, or text with models separated by commas or new lines. Namespace and key.
Part numbers metafield Text custom.alternate_part_numbers The metafield's namespace and key, separated by a dot
Show a model filter for lists longer than 6–30 12

Text block

Setting Choices Default Notes
Content Formatted text

Custom Liquid block

Setting Choices Default Notes
Liquid Liquid code Add app snippets or other Liquid code

Search results

The main section of the search template.

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Show breadcrumbs On or off On
Results per page 8–50 24
Columns on desktop 2–6 4
Columns on mobile 1 column, 2 columns 2 columns
Show result count On or off On
Enable sorting On or off On
Enable filtering On or off On Choose which filters show in the Search and Discovery app
Filter layout on desktop Sidebar, Drawer Sidebar On mobile, filters always open in a drawer

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Sections you can add

Add these to the home page, product pages and other templates with Add section.

Apps

Setting Choices Default Notes
Keep page width On or off On

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 24px

Apps: blocks from apps you install can go in this section.

Blog posts

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Eyebrow Text
Heading Formatted text From the blog
Text Formatted text
Blog A blog
Posts to show 2–9 3
Columns on desktop 2–4 3
Show featured image On or off On
Show date On or off On
Show author On or off Off
Show excerpt On or off On
Show "View all" link On or off On

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Call to action

Setting Choices Default Notes
Color scheme A color scheme Scheme 4
Eyebrow Text
Heading Formatted text Looking for a specific part?
Text Formatted text Send us the part number or your device's model, and we'll find it for you.
Button label Text "Send a part request"
Button link A link Leave blank to link to the request page in theme settings

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Collection list

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Eyebrow Text
Heading Formatted text Shop by category
Text Formatted text
Columns on desktop 2–6 4
Columns on mobile 1 column, 2 columns 2 columns
Show product count On or off Off
Show link to all collections On or off Off

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Collection block

Setting Choices Default Notes
Collection A collection
Subtitle Text

Contact details

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Eyebrow Text
Heading Formatted text Other ways to reach us
Text Formatted text
Columns on desktop 2–4 4

Spacing

Setting Choices Default Notes
Top padding 0–96px 24px
Bottom padding 0–96px 48px

Phone block

Setting Choices Default Notes
Heading Text "Call us"
Phone Text Leave blank to use Theme settings > Store details
Note Text

Email block

Setting Choices Default Notes
Heading Text "Email us"
Email Text Leave blank to use Theme settings > Store details
Note Text

WhatsApp block

Uses the WhatsApp number in Theme settings > Store details

Setting Choices Default Notes
Heading Text "Chat with us"
Note Text

Opening hours block

Setting Choices Default Notes
Heading Text "Opening hours"
Opening hours Text Leave blank to use Theme settings > Store details
Note Text

Address block

Setting Choices Default Notes
Heading Text "Find us"
Address Text Leave blank to use Theme settings > Store details
Note Text

Text block

Setting Choices Default Notes
Eyebrow Text
Heading Text
Text Formatted text
Note Text

Custom Liquid

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Liquid Liquid code Add app snippets or other Liquid code

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

FAQ

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Eyebrow Text
Heading Formatted text Frequently asked questions
Text Formatted text
Add FAQ structured data On or off On Lets search engines read these questions and answers

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Question block

Setting Choices Default Notes
Question Text "Question"
Answer Formatted text Write the answer here.
Setting Choices Default Notes
Product A product
Color scheme A color scheme Scheme 1

Media

Setting Choices Default Notes
Media layout Thumbnails, Stacked Thumbnails
Media width on desktop Small, Medium, Large Small
Enable image zoom On or off On
Loop videos On or off Off

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Apps: blocks from apps you install can go in this section.

Title block

No settings.

Part number block

Setting Choices Default Notes
Show label On or off On

Condition badge block

No settings.

Price block

No settings.

Stock source block

Setting Choices Default Notes
Show dispatch time On or off On
Show a way to ask about unavailable products On or off On Links unavailable products to the request page in Theme settings > Stock source

Variant picker block

Setting Choices Default Notes
Style Buttons, Dropdown Buttons
Show swatches On or off On

Quantity selector block

Setting Choices Default Notes
Show label On or off On

Buy buttons block

Setting Choices Default Notes
Show dynamic checkout buttons On or off On Lets shoppers check out straight away with a saved payment method
Show Shop Pay Installments On or off On
Show gift card recipient form On or off On

Pickup availability block

No settings.

Payment icons block

Setting Choices Default Notes
Heading Text Leave blank to use the default text

Share block

Setting Choices Default Notes
Show Facebook On or off On
Show X On or off On
Show WhatsApp On or off On
Show copy link On or off On
Setting Choices Default Notes
Label Text Leave blank to use the default text

Text block

Setting Choices Default Notes
Content Formatted text

Custom Liquid block

Setting Choices Default Notes
Liquid Liquid code Add app snippets or other Liquid code

Image with text

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Image An image
Image position Left, Right Left
Image ratio Adapt to image, Square, Landscape (4:3) Adapt to image
Eyebrow Text
Heading Formatted text Image with text
Text Formatted text Pair an image with a few lines about your store, a product or a service.
Button label Text
Button link A link

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Logo list

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Eyebrow Text
Heading Formatted text Brands we stock
Text Formatted text
Logo height 24–96px 48px
Scroll slowly On or off Off Pauses on hover and has a pause button. Stays still for shoppers who turn off animations.

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Logo block

Setting Choices Default Notes
Image An image
Name Text "Brand" Shown when there's no image, and used as the image's alt text
Link A link

Multicolumn

Setting Choices Default Notes
Color scheme A color scheme Scheme 2
Eyebrow Text
Heading Formatted text Why buy from us
Text Formatted text
Layout Text on the left, Text above Text on the left
Columns on desktop 2–4 2

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Item block

Setting Choices Default Notes
Icon None, Check mark, Truck, Shield, Return, Information, Store, Chat, Box Check mark
Heading Text "A reason to buy here"
Text Formatted text Tell shoppers what you do better: dispatch times, testing, warranty or support.

Newsletter

Setting Choices Default Notes
Color scheme A color scheme Scheme 2
Eyebrow Text
Heading Formatted text Get stock alerts and news
Text Formatted text New arrivals and offers, straight to your inbox.
Button label Text Leave blank to use the default text

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Product grid

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Eyebrow Text
Heading Formatted text Featured products
Text Formatted text
Collection A collection
Products to show 2–24 10
Columns on desktop 2–6 5
Columns on mobile 1 column, 2 columns 2 columns
Show as a carousel on mobile On or off Off
Show "View all" link On or off On

Product selection

Setting Choices Default Notes
Hide sold-out products On or off Off
Products of one product type 0–10 0 Stops one product type filling the grid. Set to 0 for no limit.

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Product recommendations

Setting Choices Default Notes
Heading Formatted text Related products
Recommendations Related, Complementary Related Complementary products are chosen per product in the Search and Discovery app
Products to show 2–10 5
Columns on desktop 2–6 5
Color scheme A color scheme Scheme 1

Recently viewed products

Setting Choices Default Notes
Heading Formatted text Recently viewed
Products to show 2–8 4
Columns on desktop 2–6 4
Columns on mobile 1 column, 2 columns 2 columns
Color scheme A color scheme Scheme 1

Rich text

Setting Choices Default Notes
Color scheme A color scheme Scheme 1
Eyebrow Text
Heading Formatted text Talk about your store
Text Formatted text Share what your store stands for, or anything else shoppers should know.
Button label Text
Button link A link
Alignment Left, Center Center
Content width Normal, Narrow Normal

Spacing

Setting Choices Default Notes
Top padding 0–96px 48px
Bottom padding 0–96px 48px

Panel block

Setting Choices Default Notes
Heading Text "Panel heading"
Text Formatted text Add a short note here.
Link label Text
Link A link

Slideshow

Setting Choices Default Notes
Controls color scheme A color scheme Scheme 1
Width Page width, Full width Page width
Height Small, Medium, Large, Adapt to image Medium
Show previous and next buttons On or off On
Show slide indicators On or off On
Rotate slides automatically On or off Off Pauses while shoppers hover or use the keyboard, and stays off for shoppers who turn off animations
Time per slide 3–10s 5s

Spacing

Setting Choices Default Notes
Top padding 0–96px 16px
Bottom padding 0–96px 16px

Slide block

Setting Choices Default Notes
Image An image
Mobile image An image Shown on phones instead of the image above. Leave blank to use the same image.
Color scheme A color scheme Scheme 3 Sets the text, button and overlay colors
Overlay opacity 0–80% 30%
Content position Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right Middle left
Eyebrow Text
Heading Formatted text Your headline here
Text Formatted text Introduce your store or an offer in a sentence or two.
Button label Text "Shop now"
Button link A link
Second button label Text
Second button link A link
Second button style Outline button, Text link Outline button