Duskline Theme docs

Customize

Sections

Sections are the building blocks of each page. In the theme editor, select Add section to add one, and drag sections to reorder them.

Settings most sections share

Color scheme
Which of your color schemes the section uses. Edit schemes in Theme settings > Colors.
Eyebrow
A short line of small uppercase text above the heading. Leave empty to hide it.
Show during
Shows this section only at these times of day, by each visitor's local time: All day, Day, Dusk, Night, Day and dusk or Dusk and night. Hours are set in Theme settings > Dayparts. See Show during for the sections that have it.Default: All day.
Section padding: Top padding, Bottom padding
Space above and below the section's content.0px to 100px or 0px to 140px, depending on the section. On phones, padding is reduced by a quarter.

When an image setting is empty, Duskline shows a placeholder illustration so you can see the layout while you work.

Background videos

The Time of day hero, Image banner, Editorial band and Gift guide sections have a Video setting for a video uploaded to your store. Background videos play muted on loop and always come with a pause button. The video is loaded only when the section is on screen. Visitors who prefer reduced motion, use a data saver or are on a very slow connection see the image instead.

The header is part of the header group and appears on every page. Change your logo, inverse logo and logo width in Theme settings > Logo.

Desktop layout
Logo center, menu left, Logo left, menu center or Logo left, menu left.
Menu
The main menu. Supports up to three levels. Menu items with three levels open a mega menu.Default: main-menu.
Show shop panel
Menu items that link to a collection, all products or the collections list, and have no submenu, open one shared panel on desktop and show as image tiles in the mobile menu. See Shop panel.
Secondary menu
Shown in the shop panel and in the mobile menu, for help or company links. Links already in the main menu are skipped.
Sticky header
None: the header scrolls away. Always: the header stays at the top. On scroll up: the header hides while scrolling down and returns when scrolling up.Default: Always.
Show separator line
A thin line under the header.
Color scheme
Colors of the header bar.
Menu color scheme
Used by dropdowns, mega menus and the mobile menu.

Transparent header

Use transparent header on home page
On the home page, the header sits transparently over the first section when that section supports it: a Time of day hero or Image banner with Use header overlay turned on. The header becomes solid as the page scrolls. Add an Inverse logo in Theme settings > Logo so your logo stays visible.
Transparent header text
Color of menu text and icons while the header is transparent. Shown when the transparent header is on.Default: white.

Icons

Cart icon
Bag or Cart.
Customer account menu
Links shown with the account icon.Default: customer-account-main-menu.

Country/region and language

Show country/region selector
Shown in the header on desktop and in the mobile menu. Add countries and regions in your Markets settings.
Show language selector
Add languages in your language settings.

Featured card

Image, Label, Heading, Button label, Link
A promotional card shown in the shop panel and at the top of the mobile menu.Default label: New in. Default button label: Shop now.

Shop panel

Featured product
A product shown in the shop panel.
Featured product label
A short label for the featured product.Default: Bestseller.
Perks
One per line. Shown along the bottom of the shop panel and the mobile menu. Use [free_shipping_threshold] to show the free shipping threshold from Theme settings > Cart.

Mobile menu

Show social media icons
Shows your social media icons in the mobile menu. Add the links in Theme settings > Social media.

Shop panel

With Show shop panel on, top-level menu items that link to a collection, to all products or to the collections list, and that have no submenu, share one full-width panel on desktop. The panel lists those shop links with a small image, your other menu links and the secondary menu, the featured card, the featured product and your perks. In the mobile menu, the same shop links show as image tiles. Menu items with a submenu keep their dropdown or mega menu. Turn the setting off to show every menu item as a plain link, dropdown or mega menu.

Block: Mega menu image

Adds an image to one mega menu. Up to 12 blocks.

Menu item
Enter a top-level menu item heading exactly as it appears in your menu. Its submenu opens as a mega menu with this image.
Image
The image.
Heading
Text shown with the image.
Link
Where the image leads. Defaults to the menu item link.

Announcement bar

A narrow bar above the header for short messages. It belongs to the header group.

Color scheme
Default: Scheme 3.
Auto-rotate announcements
With more than one announcement, shows them one at a time.
Change announcements every
Shown when auto-rotate is on. 3 to 10 seconds. Default 5 seconds.

Country/region and language

Show country/region selector
Shown on desktop.
Show language selector
Shown on desktop.

Block: Announcement

Up to 6 announcements.

Text
The message. Use [free_shipping_threshold] to show the free shipping threshold from Theme settings > Cart, for example "Free shipping on orders over [free_shipping_threshold]". The announcement is hidden while the threshold is 0. Use [greeting] to greet visitors by their time of day. See The [greeting] token.
Link
Makes the announcement a link.
Show during
Shows this announcement only at these times of day, by each visitor's local time: All day, Day, Dusk, Night, Day and dusk or Dusk and night. To see another time of day in the editor, use Theme settings > Dayparts > Preview daypart.Default: All day.
Multiple currencies

The [free_shipping_threshold] placeholder shows the amount you entered in your store's currency. It is not converted for shoppers browsing in another currency, so if you sell in several currencies, write the amount in words that suit all markets or leave the placeholder out. The progress bar in the cart is converted. See Cart.

Part of the footer group, shown on every page. Up to 8 blocks.

Color scheme
Default: Scheme 3.
Show large store name
Shows your store name in large, faint letters along the bottom edge.

Country/region and language

Show country/region selector
Add countries and regions in your Markets settings.
Show language selector
Add languages in your language settings.

Appearance switch

Show appearance switch
Lets visitors keep the light or dark colors, or follow the time of day. Appears only when Change colors with the time of day and its appearance switch are on in Theme settings > Dayparts. See The appearance switch.Default: on.

Follow on Shop

Show Follow on Shop
Lets customers follow your store on the Shop app. Shop Pay must be enabled.

Utilities

Show payment icons
Icons for the payment methods your store accepts.
Payment icon style
Subtle or Full color. Shown when payment icons are on.Default: Subtle.
Show policy links
Links to your store policies. Add policies in your policy settings.
Copyright note
Short line shown after your store name, for example the company that operates the store.
Contact email
Shown after the copyright line as an email link. Leave empty to hide it.

Section padding

Top padding, Bottom padding
Defaults 100px and 32px.

Footer blocks

Menu
Heading and Menu. Shows top-level menu items only.Default menu: footer.
Text
Heading and Text, for contact details, store information or brand content.
Email signup
Heading, Text and Button label for an email field. Subscribers are added to your customer list with marketing consent. One per footer.
Image
Image, Image width (50px to 300px) and Link. Useful for a badge or a second logo.
Social media icons
Heading. Add your social media links in Theme settings > Social media. One per footer. Without any social media links, the block is not shown.

Time of day hero

Duskline's signature hero. The hero follows each visitor's local time. Set an image, optional video, color scheme and eyebrow for day, dusk and night. A phase without its own image or video uses the day image and video. Type [greeting] in the heading, subheading or an eyebrow to greet visitors by their time of day. The hero is part of Dayparts, the system that lets the whole store follow the time of day.

How the phases work

The hero reads the clock on the visitor's device and chooses a phase:

  • Day: from Day starts at until Dusk starts at.
  • Dusk: from Dusk starts at until Night starts at.
  • Night: from Night starts at until Day starts at the next morning.

With the defaults, a visitor sees day from 6:00 to 16:59, dusk from 17:00 to 20:59 and night from 21:00 to 5:59. The heading, subheading and button are the same in every phase; the image, mobile image, video, inset image, eyebrow and color scheme change. Only the media for the current phase is downloaded.

Show during
Shows the whole hero only at certain times of day. See Settings most sections share.
Preview phase in the editor
Visitor's local time, Day, Dusk or Night. Only applies in the theme editor. Visitor's local time follows Theme settings > Dayparts > Preview daypart. Visitors always see the phase for their local time.
Day starts at
Leave the three hours at 6, 17 and 21 to follow Theme settings > Dayparts. Change them to give this section its own hours. Hours use the 24-hour clock.0h to 23h. Default 6h.
Dusk starts at
Default 17h.
Night starts at
Default 21h.

Day, Dusk, Night (one group each)

Image
The full-width image for the phase.
Mobile image
Optional. Shown on screens under 750px. A phase without its own image also uses the day mobile image.
Video
Plays muted on loop. Its first frame shows until it starts, so the image above is not used while a video is set. See Video in the hero.
Inset image
Optional small framed image shown over the hero. A phase without its own inset uses the day inset.
Eyebrow
Short text above the heading, with a sun, sunset or moon icon.Defaults: Morning light, Golden hour, After dark.
Color scheme
Text and button colors for the phase.Defaults: Scheme 3 (day), Scheme 4 (dusk), Scheme 3 (night).

Text

Heading
The large heading. Line breaks you type are kept.
Subheading
A short paragraph under the heading.
Button label
Leave empty to hide the button.
Button link
Where the button leads. When empty, it leads to all products.
Use heading as the page's main heading
Turn on only when no other section on the page has a main heading.

Layout

Text position
Bottom left, Middle left, Bottom center, Middle center, Middle right or Bottom right.
Height
Small, Medium, Large or Full screen.Default: Large.
Desktop layout
Full width or Triptych. Triptych shows portrait media three times side by side on desktop. A video plays in all three, each a few seconds apart. Mobile always shows one full-width image or video.Default: Full width.
Overlay opacity
Darkens the media so text stays readable.0% to 90%. Default 55%.
Show sound button
Lets visitors turn on the video's sound. Use only for videos with sound. Videos always start muted.Default: off.
Use header overlay
Makes the header transparent over this section when it is the first section on the home page and Use transparent header on home page is on in the header.

Video in the hero

Each phase can have a Video uploaded to your store.

  • First frame as the poster. While a video is set, the hero shows the video's own first frame until the video starts, so there is no visible jump from a different picture. The phase's Image and Mobile image are not used. The image is only a fallback for the short time after upload while Shopify is still preparing the video's preview.
  • Phases. A phase with its own video plays it. A phase with neither its own image nor its own video uses the day image and video. A phase with its own image and no video shows that image.
  • Pause button. A pause and play button appears on the hero whenever a video is playing.
  • Sound button. With Show sound button on, a second button lets visitors turn the sound on and off. Videos always start muted, because browsers do not allow sound before a visitor asks for it.
  • When the video does not play. Visitors who prefer reduced motion, use a data saver or are on a very slow connection see the first frame as a still image.

Triptych layout

Set Desktop layout to Triptych to show the phase's media in three portrait panes side by side on desktop screens (990px and wider). Use a portrait image or video. A video is downloaded once and plays in all three panes, each a few seconds apart. On smaller screens the hero shows one full-width image or video.

Tip

Use three photos or clips from the same shoot at different times of day, or the same scene with different light. Keep the subject in a similar place in each one so the text position works for all three.

Slideshow

Full-width image slides with text. Up to 5 slides.

Full width
When off, the slideshow is limited to the page width.
Slide height
Small, Medium, Large or Full screen.
Auto-rotate slides
Slides stop rotating on hover, focus and when visitors prefer reduced motion. A pause button is always shown.
Change slides every
3 to 9 seconds. Default 6 seconds.

Accessibility

Slideshow description
Describes the slideshow for people using screen readers.

Block: Slide

Image, Mobile image
The slide image, and an optional image for phones.
Eyebrow, Heading, Subheading
Slide text.
Button label, Button link
Leave the label empty to hide the button.
Text position
Bottom left, Bottom center or Middle center.
Overlay opacity
0% to 90%. Default 50%.
Color scheme
Text and button colors for this slide.

Image banner

A single full-width image or video with text over it.

Image, Mobile image
The banner image, and an optional image for phones.
Video
Plays muted on loop. The image is used as the poster and on slow connections. See Background videos.
Height
Small, Medium, Large or Full screen.
Text position
Bottom left, Middle left, Bottom center or Middle center.
Overlay opacity
0% to 90%. Default 40%.
Use header overlay
Makes the header transparent over this section when it is the first section on the home page and the header's transparent setting is on.

Text

Eyebrow, Heading, Body text
Banner text.
Button label, Button link
Leave the label empty to hide the button.
Color scheme
Text and button colors.

Image with text

Pair text with an image to focus on your chosen product, collection or story.

Image
The image.
Image ratio
Adapt to image, Portrait, Square or Landscape.
Image position
Left or Right on desktop.
Full width split
The image runs to the edge of the screen with text on a color panel. Section padding is not used.

Text

Eyebrow, Heading, Body text
The text.
Text alignment
Left or Center.
Button label, Button link
Leave the label empty to hide the button.
Button style
Primary, Secondary or Text link.

Rich text

Text-only content, such as a brand statement.

Alignment
Left or Center.
Width
Narrow or Normal.

Blocks

Eyebrow
Text. One per section.
Heading
Heading and Heading size (Small, Medium or Large). Up to two per section.
Text
Body text.
Button
Button label, Button link and Button style. One per section.

Products from one collection, as a grid or as one row. Cards follow Theme settings > Product cards.

Eyebrow, Heading
Text above the products.
Collection
The collection to show.
Layout
Grid or Product row. Product row shows one horizontal row with arrows on desktop and swipe on mobile.Default: Grid.
Maximum products to show
2 to 12. Default 4.
Number of columns on desktop
2 to 4. Default 4.
Show "View all" button
Shown when the collection has more products than are displayed, or when a custom link is set.
"View all" label
Optional. Replaces the default label.
"View all" link
Optional. Defaults to the collection.

Mobile layout

Number of columns on mobile
1 column or 2 columns.
Enable swipe on mobile
Shows products in a row that shoppers swipe sideways on phones.

Use Product row when you want to show more products than fit in one line without making the section taller: set Maximum products to show higher than Number of columns on desktop, and shoppers move through the row with the arrows. The arrows are hidden when all products fit.

Collection list

Image links to your collections. Up to 12 collections.

Eyebrow, Heading
Text above the list.
Image ratio
Adapt to image, Tall, Portrait, Square or Landscape.Default: Tall.
Card style
Title on the image or Title below the image.
Number of columns on desktop
2 to 5. Default 4.
Mobile layout
Swipe row, 1 column or 2 columns.Default: Swipe row.
Button label
Shown next to the heading on larger screens. Leave empty to hide.
Button link
Defaults to the list of all collections.

Block: Collection

Collection
The collection.
Image
Optional. Replaces the collection's featured image.
Heading
Optional. Replaces the collection title.
Link
Optional. Replaces the link to the collection, for example a search for a print.

Swatch

Swatch color
Optional. Shows a small dot next to the heading.
Second swatch color
Used by the stripes, checks and spots patterns.
Swatch pattern
Solid, Stripes, Checks or Spots.

Collection tabs

Several collections in one place, one tab each. Shoppers switch tabs without leaving the page. Up to 5 collections. Products of the first tab load with the page; the others load when their tab is opened. Each tab is also a link to its collection, so it still works without JavaScript.

Eyebrow, Heading
Text above the tabs.Default heading: Shop by collection.
Tab style
Underlined text or Pills.
Alignment
Left or Center.
Maximum products to show
Per tab.2 to 12. Default 4.
Number of columns on desktop
2 to 5. Default 4.
Show "View all" button
Links to the collection of the open tab.

Mobile layout

Number of columns on mobile
1 column or 2 columns.
Enable swipe on mobile
Shows the products in a swipe row on mobile.Default: off.

Block: Collection

Collection
The collection for this tab.
Tab label
Optional. Defaults to the collection title.

Collection by time of day

Shows a different collection for day, dusk and night, by each visitor's local time. A time of day without its own collection or text uses the day one. Hours are set in Theme settings > Dayparts, where Preview daypart shows another time of day in the editor. See Dayparts.

Day, Dusk, Night (one group each)

Eyebrow
Short text above the heading, with a sun, sunset or moon icon.Defaults: For the day, For the evening, For the night.
Heading
Type [greeting] to greet visitors by their time of day. The token also works in the eyebrow and the text.
Text
A short paragraph under the heading.
Collection
The collection whose products show during this time of day.

Layout

Maximum products to show
2 to 8. Default 4.
Number of columns on desktop
2 to 4. Default 4.
Show "View all" button
Shown when the collection has more products than are displayed.
Enable swipe on mobile
Shows the products in a swipe row on mobile.Default: on.

Only the products for the visitor's time of day are shown, and only their images are downloaded.

Recently viewed

Shows the products a visitor looked at most recently, saved in their browser. The section stays hidden until the visitor has viewed a product. Add it to the product template, the cart or the home page.

Eyebrow, Heading, Heading size
Text above the products.Default heading: Recently viewed.
Maximum products to show
2 to 12. Default 4.
Number of columns on desktop
2 to 6. Default 4.

Mobile layout

Number of columns on mobile
1 column or 2 columns.
Enable swipe on mobile
Default: on.
  • The product being viewed is never listed.
  • The list lives in the visitor's browser only. It is not tied to a customer account, so it does not follow a shopper to another device, and it is empty in a private window or after they clear their browser data.
  • Nothing is saved for visitors who have declined preference storage in your store's cookie banner.
  • In the theme editor, the section shows placeholder cards so you can design it.

Multicolumn

Columns with an icon or image, a heading and text. Up to 8 columns.

Eyebrow, Heading
Text above the columns.
Style
Columns, Cards or Compact strip.
Number of columns on desktop
1 to 4. Default 3.
Text alignment
Left or Center.
Image ratio
Adapt to image, Portrait, Square or Landscape.

Block: Column

Icon
One of the built-in icons, or None.
Image
Replaces the icon.
Heading, Body text
Column text.
Link label, Link
An optional link under the text.

Collapsible content

Questions and answers, or any content in expandable rows.

Eyebrow, Heading, Body text
Introduction shown beside the rows on desktop.
Image
Optional image under the introduction.
Heading position on desktop
Left or Right: which side the introduction (heading, text and image) appears on.
Open first row
Shows the first row expanded when the page loads.

Block: Collapsible row

Heading
The row title, such as a question.
Row content
The text shown when the row is opened.
Row content from page
Also shows the content of the page you choose, after the row content.

Lookbook mosaic

An editorial grid of images. Add three to five images. The layout adjusts to the number of images.

Eyebrow, Heading
Text above the images.
Link label, Link
A link beside the heading, for example to a collection.

Block: Image

Image
The image.
Caption
Shown with the image. Also used as the link's name for screen readers.
Link
Makes the image a link.

Shop the look

A row of look photos with product hotspots. Selecting a hotspot opens a small card with the product's image, title, color and price, and a link to the product. Up to 12 looks, each with up to 4 products.

Eyebrow, Heading, Text
Text above the looks.
Image ratio
Portrait, Tall or Square.
Show quick add in product cards
Adds a quick add button to the card a hotspot opens.
List products under each look
Also lists each look's products under its photo.
Product card color scheme
Colors of the card a hotspot opens.

Block: Look

Add up to 4 products. Place each hotspot with the horizontal and vertical position, measured from the image's top left corner.

Image
The look photo.

Product 1 to Product 4 (one group each)

Product
The product the hotspot shows.
Horizontal position
0% (left edge) to 100% (right edge).
Vertical position
0% (top edge) to 100% (bottom edge).

Editorial band

A wide band with one statement over an image or video, or on its own on a color scheme.

Image
The background image.
Video
Plays muted on loop. The image is used as the poster and on slow connections. See Background videos.
Show placeholder when no image is selected
Turn off to use the section as a text statement on its color scheme.
Height
Small, Medium or Large.
Text position
Bottom left or Middle center.
Overlay opacity
0% to 90%. Default 70%.

Text

Eyebrow
Small text above the statement.
Heading
The statement.
Button label, Button link
An optional button.

Gift guide

A large image or video beside a heading, text, a button and a short list of gift ideas. Up to 4 Product blocks.

Image
The large image.
Video
Optional. Plays muted on loop over the image. See Background videos.
Media ratio
Portrait, Square or Landscape.
Media position on desktop
Left or Right.

Text

Eyebrow, Heading, Text
The introduction.
Button label, Button link
An optional button.
Gift ideas style
Rows with thumbnails or Product cards.

Order deadline

Order deadline
Optional. Enter a real date as YYYY-MM-DD. The deadline is the end of that day in your store's time zone, and the line hides once the date has passed.
Deadline label
Use [date] to insert the deadline date.Default: Order by [date] for delivery before the holidays.
Show days and hours left
Shows the time left until the deadline you entered. Nothing shows when the date is empty, not a valid date or in the past.

Block: Product

Product
The product to suggest.
Heading
Optional. For example, who the gift is for.
Text
A short line under the heading.
Link
Optional. Rows link here instead of the product, for example to a collection.
Image
Optional. Replaces the product image in rows.

Timeline

Walk customers through a day with your products, one moment at a time. Up to 6 moments.

Eyebrow, Heading, Subheading
Text above the moments.
Style
Photo cards or Photo with text below. Photo cards show the time and heading on the image, in a swipe row on mobile.
Heading alignment
Left or Center.
Image ratio
Portrait, Square or Landscape.
Button label
Leave empty to hide.
Button link
Where the button leads.

Block: Moment

Time label
Any text, for example 6:30 pm or Morning.
Image
The photo for the moment.
Heading, Text
The moment's text.
Link
Optional. Links the card, or the heading when text shows below the photo.
Link label
Optional. Adds a text link under the moment when text shows below the photo.

Video

Eyebrow, Heading
Text above the video.
Shopify-hosted video
A video uploaded to your store. Replaces the external video below.
YouTube or Vimeo link
A video from YouTube or Vimeo. It loads only when the visitor presses play.
Cover image
Shown before the video plays.
Video alt text
Describe the video for customers using screen readers.
Full width
Runs the video to the edges of the screen.

A gallery of images and videos. Up to 24 items.

Eyebrow, Heading, Body text, Heading alignment
Text above the gallery.

Layout

Layout
Grid, Columns or One large and small tiles. Columns keeps each item's own proportions. One large and small tiles looks best with 5 items in 4 columns.Default: One large and small tiles.
Image ratio
Adapt to image, Portrait, Square or Landscape. Used by the grid and the tile layouts.
Number of columns on desktop
2 to 5. Default 4.
Number of columns on mobile
1 column or 2 columns.
Space between items
0px to 40px. Default 16px.
Make gallery full width
Spreads the gallery to the edges of the screen.
Open items in a full-screen viewer
Selecting an item opens it full screen. Items with a link open the link instead. When this is off, videos play in place.Default: on.

Block: Image

Image, Caption, Link
The image, an optional caption and an optional link.

Block: Video

Video
A video uploaded to your store.
Video URL
A YouTube or Vimeo address. Used when no video is selected.
Cover image, Caption, Link
The image shown before the video plays, an optional caption and an optional link.

Before and after

Two images of the same subject in one frame, with a divider that shoppers drag to compare them. The divider also moves with the arrow keys. Without JavaScript, the frame shows the start position.

Eyebrow, Heading, Text, Text alignment
Text above the images.

Images

Before image, Before label
The first image and the label shown on it.Default label: Before.
After image, After label
The second image and its label.Default label: After.
Image ratio
Adapt to before image, Portrait, Square, Landscape or Wide. Both images are cropped to the same frame, so use two images with the same framing.Default: Landscape.

Divider

Direction
Side by side or Top and bottom.
Start position
Where the divider starts.10% to 90%. Default 50%.

Layout

Width
Narrow, Page width or Full width.

Image with hotspots

One large image with up to 8 hotspots. A hotspot points at a product or at your own text. On desktop, its card opens next to the hotspot; on mobile, it sits over the bottom of the image. To tag products on a row of look photos, use Shop the look instead.

Eyebrow, Heading, Text, Text alignment
Text above the image.

Image

Image
The image the hotspots sit on.
Mobile image
Optional. Shown at its own ratio on small screens. Each hotspot can have its own position on this image.
Image ratio
Adapt to image, Portrait, Square, Landscape or Wide.
Width
Page width or Full width.

Hotspots

List hotspots under the image on desktop
Lists every hotspot's content under the image. The list always shows on mobile.
Hotspot card color scheme
Colors of the card that opens.

Block: Hotspot

Horizontal position, Vertical position
Place the hotspot, measured from the image's top left corner.0% to 100%. Default 50%.
Product
Shows the product's image, title and price in place of the custom content.
Heading, Text, Link label, Link
Custom content, used when no product is selected.
Use a different position on the mobile image
Turn on when you use a Mobile image with a different crop, then set Horizontal position on mobile and Vertical position on mobile.

Testimonials

Customer quotes. Up to 9. Only share words your customers actually wrote, with their permission.

Eyebrow, Heading
Text above the quotes.
Enable swipe on mobile
Shows quotes in a row that shoppers swipe sideways on phones.

Block: Testimonial

Eyebrow
Optional short note, such as the product name.
Quote
The customer's words.
Author, Author detail
Who said it, and an optional detail such as their city.
Author image
Optional photo.

Logo list

A row of logos, such as press mentions or partners. Up to 12 logos.

Heading
Default: As featured in.
Logo height
20px to 80px. Default 36px.

Block: Logo

Image
The logo.
Name
Read by screen readers when the image has no alt text.
Link
Makes the logo a link.

Countdown

Counts down to a launch, a sale end or a shipping deadline. The timer counts down to the date you set for every visitor and stops when it passes. It does not restart, and there is no timer that begins again for each visitor.

Eyebrow, Heading, Text
Text shown with the timer.
Button label, Button link
An optional button.Default label: Shop now.

End date

End date
Use the format YYYY-MM-DD, for example 2026-11-27.
End time
Use the 24-hour format HH:MM.Default: 23:59.
Time zone
Visitor's local time or a UTC offset from UTC-12:00 to UTC+14:00. With a UTC offset the countdown ends at the same moment everywhere. Offsets do not follow daylight saving time. With Visitor's local time, it ends when that date and time arrive on each visitor's own clock.Default: UTC.
Show seconds
Shows seconds next to days, hours and minutes.

When the countdown ends

After the end date
Show a message or Hide the section.Default: Show a message.
Message
Replaces the text, timer and button after the end date.Default: This event has ended.

Layout

Background image
An optional image behind the text.
Overlay opacity
Tints the image with the color scheme's background to keep text readable.0% to 90%. Default 60%.
Height
Fit content, Medium or Large.
Text alignment
Left or Center.
  • Until you enter a valid end date, the timer is not shown. The theme editor shows a reminder to add one.
  • To find your offset, compare your local time with UTC. For example, New York is UTC-05:00 in winter and UTC-04:00 in summer. Because offsets do not follow daylight saving time, choose the one that applies on the end date.
  • When Hide the section is chosen and the date has passed, the section stays visible in the theme editor with a note, so you can still edit or remove it.

Comparison table

Compare up to 4 products or plans side by side. Add a Column block for each one and a Row block for each feature. On narrow screens the table scrolls sideways and the row labels stay in place.

Eyebrow, Heading, Text, Text alignment
Text above the table.

Table

Show column images
Shows an image at the top of each column.
Image ratio
Square or Portrait.
Column alignment
Left or Center.
Shade alternate rows
Gives every other row a light background.

Block: Column

Up to 4 columns.

Product
Fills the image, heading, price and link. The settings below replace them.
Heading, Image
Your own column heading and image.
Price
For example a plan price. Leave empty to use the product's price.
Button label, Button link
Leave the link empty to link to the product.
Highlight this column
Makes one column stand out.
Badge
Shows above a highlighted column, for example "Most popular".

Block: Row

Label
The name of the feature.
Note
Optional small text under the label.
Column 1 value, Column 2 value, Column 3 value, Column 4 value
Enter one value per column. Type yes for a check mark or no for a cross. Any other text is shown as typed.

The section holds up to 24 blocks in total, columns and rows together. Values are typed by hand; they are not read from product data.

Store locations

Lists your stores or stockists with address, opening hours, phone number and a directions link. Up to 12 locations. There is no embedded map: the directions link opens Google Maps in a new tab.

Eyebrow, Heading, Text, Text alignment
Text above the locations.

Layout

Layout
Cards grid (each location with its own image) or List with one large image.

Cards grid

Number of columns on desktop
1 to 4. Default 3.
Show location images
Shows each location's image.
Image ratio
Portrait, Square, Landscape or Wide.

List with one large image

Image
Leave empty to use the first location's image.
Image position on desktop
Left or Right.

Block: Location

Name
The store name.
Note
A short label next to the name, for example a new store.
Address, Opening hours, Phone number
The location's details. The phone number is a link that starts a call on phones.
Image
A photo of the location.
Directions link
Leave empty to build a map search link from the address.

This section shows the details you type. It does not read your Shopify locations and does not show stock per store. For in-store pickup on product pages, see Pickup availability.

Marquee

A band of short texts and logos that scrolls across the screen. Up to 10 items.

Speed
Slow, Medium or Fast.
Direction
Right to left or Left to right.
Pause on hover
The marquee always pauses on keyboard focus and with its pause button, and stays still for visitors who prefer reduced motion.

Text

Text size
Small, Medium or Large.
Font
Heading or Body.
Uppercase text
Shows the text in capital letters.
Separator
None, Dot, Sparkle or Slash between items.

Layout

Space between items
16px to 96px. Default 40px.
Image height
16px to 96px. Default 32px.
Show top and bottom borders
Adds a line above and below the band.

Block: Text

Text, Link
A short message and an optional link.

Block: Image

Image
A logo or small image.
Name
Read by screen readers when the image has no alt text.
Link
Makes the image a link.

Email signup

An email field for your newsletter. Subscribers are added to your customer list with the tag newsletter.

Eyebrow, Heading, Body text
Text above the field.
Button label
Default: Subscribe.
Color scheme
Default: Scheme 5.

Blog posts

Recent posts from one blog.

Eyebrow, Heading
Text above the posts.
Blog
The blog to show posts from.
Number of posts to show
2 to 6. Default 3.
Number of columns on desktop
2 to 4. Default 3.
Image ratio
Landscape, Portrait or Square.
Show featured image, Show date, Show author
Choose what each post card shows.
Show "View all" button
Links to the blog.

Contact form

A form with name, email, optional phone number and message fields. Messages go to your store's sender email address. The theme's page.contact template already includes this section; assign it to your contact page in Online Store > Pages.

Heading, Body text
Text above the form.
Show phone number field
Adds an optional phone field.

One product with its media and buy buttons, anywhere in your store.

Product
The product to show.
Heading, Heading size
Optional heading above the section.

Media

Desktop media width
Small, Medium or Large.
Desktop media position
Left or Right.
Enable image zoom
Opens images full screen when selected.
Show link to product page
Adds a link to the full product page.
Show part of the next media on mobile
On mobile, the edge of the next image shows, as a hint that there is more to swipe.Default: off.

Badges

Badges from product tags
Works as on the product page. See Badges.
Show a New badge after publishing for
0 to 60 days. Set to 0 to hide the badge.

Blocks: Text, Title, Price, Variant picker, Buy buttons, Description, Back in stock request, Payment icons, Trust list, Specifications table, Share, Custom Liquid and app blocks. They work like the blocks of the same name on the product page.

Product recommendations

Available on product templates. Recommendations update over time based on order and product data. You can also choose related products with the Search and Discovery app.

Heading, Heading size
Default heading: You may also like.
Button label
Leave empty to hide the button.Default: Shop all.
Button link
Links to all products when empty.
Maximum products to show
2 to 10. Default 4.
Number of columns on desktop
2 to 5. Default 4.
Enable swipe on mobile
Shows products in a row that shoppers swipe sideways on phones.

Custom Liquid

Add app snippets or other code to create advanced customizations.

Liquid code
Your Liquid, HTML, CSS or JavaScript.
Full width
Removes the page width limit.
Custom code is not covered by support

We can't help write or fix code added in Custom Liquid. If a page breaks after adding code, hide the section to restore it. See the support policy.

Apps

Holds app blocks from apps you have installed.

Make section margins the same as theme
When on, the app content is limited to the page width like other sections.

Product information and Featured product also accept app blocks directly.

Overlays

Four sections sit on top of your pages instead of inside them: Email signup popup, Promo popup, Age verifier and Back-to-top button. They live in their own group, Overlays, in the theme editor's section list, below the footer, and show on every page except the password page.

Off by default

All four overlays start hidden. To turn one on, find it under Overlays in the theme editor and select its eye icon. To add one back after removing it, select Add section in the Overlays group. In the theme editor, the popups and the age verifier are shown only while their section is selected.

Email signup popup

A dialog that invites visitors to subscribe. Subscribers are added to your customer list with the tag newsletter.

Image
An optional image beside the text.
Image position on desktop
Left or Right.
Show image on mobile
Default: off.
Eyebrow, Heading, Body text, Button label
The popup's text.Default heading: Subscribe to our emails.
Dismiss link label
Leave empty to hide the link. The close button is always shown.Default: No, thanks.

After signup

Heading, Body text
Shown in the popup after a successful signup. To preview it in the theme editor, select the popup button.Default heading: Thanks for subscribing.
Code text
Optional. Shown as plain text with a copy button, for example a discount code you created in your Shopify admin. The theme does not create or apply discounts.

Behavior

Show on
All pages or Home page only.
Show popup
After a delay, After scrolling, On exit intent or After a number of page views. Exit intent opens the popup when the pointer leaves through the top of the window; touch devices use the delay instead.
Delay
2 to 60 seconds. Default 8 seconds. Also the wait on the page that reaches the page view count.
Scroll depth
Share of the page a visitor scrolls before the popup opens.10% to 90%. Default 40%.
Page views
Pages a visitor opens in one visit before the popup is shown.2 to 10. Default 3.
Days before showing again
Each visitor sees the popup once, then not again for this many days.1 to 90. Default 14.
Hide from visitors who subscribed
A successful signup is remembered in the visitor's browser.Default: on.
Hide from logged-in customers
Default: off.
Show on mobile
Default: on.

Teaser button

Show teaser button
A small button in a screen corner that reopens the popup after a visitor closed it. Visitors can hide it for good.Default: off.
Teaser label
Default: Join our emails.
Teaser position
Bottom left or Bottom right. In the same corner as the back-to-top button, the teaser sits above it.
Distance from the bottom
Increase it to keep the teaser clear of a chat button.16 to 120 px. Default 24 px.
Color scheme
Default: Scheme 1.

The popup closes with its close button, the Esc key or a click outside it. "Once per visitor" is remembered in the visitor's browser, so a visitor on another device or with cleared browser data can see it again. The popup collects email addresses only. Shopify theme forms do not record SMS consent, so use an SMS app to collect phone numbers.

Promo popup

A dialog without a form, to announce a launch, an event or a sale period. Only one popup opens per page view: when the email signup popup is due, this one waits for a later page view. Neither opens while the age verifier is showing.

Image, Image position on desktop, Show image on mobile
An optional image beside the text.
Eyebrow, Heading, Body text
The announcement.
Code text
Optional. Shown as plain text with a copy button. The theme does not create or apply discounts.
Button label, Button link
Where the popup sends visitors.Default label: Shop now.

Behavior

Show on
All pages or Home page only.
Show popup
After a delay, After scrolling, On exit intent or After a number of page views. Exit intent opens the popup when the pointer leaves through the top of the window; touch devices use the delay instead.
Delay
2 to 60 seconds. Default 8 seconds. Also the wait on the page that reaches the page view count.
Scroll depth
Share of the page a visitor scrolls before the popup opens.10% to 90%. Default 40%.
Page views
Pages a visitor opens in one visit before the popup is shown.2 to 10. Default 3.
Days before showing again
Each visitor sees the popup once, then not again for this many days. Changing the heading, text, code or link starts a new announcement that everyone sees once.1 to 90. Default 14.
Hide from logged-in customers
Default: off.
Show on mobile
Default: on.
Color scheme
Default: Scheme 1.

Age verifier

Asks visitors to confirm their age before they browse the store. The dialog cannot be closed with the Esc key or by clicking outside it: visitors confirm or decline.

Show logo
Uses the logo from Theme settings > Logo.
Heading, Body text
The question.Default heading: Confirm your age.
Confirm button label
Default: I am of legal age.
Decline button label
Default: I am not.
Days to remember a confirmation
Set to 0 to ask again in every new browser session.0 to 90. Default 30.

When a visitor declines

Heading, Body text
The message shown to visitors who decline.Default heading: Sorry, you cannot enter.
Redirect link
Optional. Sends visitors who decline to this link instead of showing the message.
Color scheme
Default: Scheme 1.
A confirmation, not an identity check

The age verifier asks visitors to state that they are of legal age. It does not ask for a date of birth and does not verify identity or age, and it does not appear for visitors without JavaScript. If the law in your market requires real age verification, use a dedicated service or app.

Back-to-top button

A round button that appears once a visitor has scrolled down and returns them to the top of the page.

Show after scrolling
Measured in screen heights: 100% is one full screen.50% to 300%. Default 100%.
Position
Bottom left or Bottom right.
Distance from the bottom
Increase it to keep the button clear of a chat button or the sticky add to cart bar.16px to 120px. Default 24px.
Show on mobile
Default: on.
Color scheme
Default: Scheme 1.

Template sections

These sections hold the main content of a template. They can't be removed, but they have settings.

SectionTemplateSettings
Product informationProductsSee Product pages.
CollectionCollectionsSee Collections and search.
Search resultsSearchSee Collections and search.
CartCartSee Cart.
Collections list pageCollections listEyebrow; Heading; Sort collections (alphabetically, by date or by product count, applied to the collections shown on each page); Image ratio; Text position (On the image or Below the image); Columns on desktop (2 to 4); Columns on mobile; Show product count.
Blog postsBlogsFeature the first post; Image ratio; Show featured image; Show date; Show author; Show tag filter.
Blog postBlog postsShow featured image; Featured image height (Adapt to image, Small, Medium); Show author; Show share button.
PagePagesContent width: Narrow or Normal.
Page not found404 pageSection padding.
Password pagePasswordBackground image; Overlay opacity; Show email signup; Email signup text; Color scheme.

The cart drawer is also a section with its own settings. See Cart drawer section.