Lustre theme documentation

Square image, at least 32 x 32 px

When the shopper's device is in dark mode, light color schemes use the dark scheme below. Off by default, so the store looks the same for everyone.

One column gives long product titles more room.

A bar with the add button at the bottom of phone screens once the page scrolls past the buy buttons. An app with its own sticky bar takes its place.

Stack lists every image (phones swipe through them); Thumbnails shows one image and a row of thumbnails; Carousel is one swipeable strip with a counter.

Days a shopper has to return an item. Above 0 the returns row of the service block says it and the product structured data carries a return policy with it. 0 states nothing.

A public Storefront API access token (Headless channel, or a custom app with unauthenticated_read_product_listings). Build a routine reads bundle components with it. Leave it blank to hide that section.

Shows prices as $10.00 USD instead of $10.00. Useful when you sell in several currencies.

Shoppers who ask their device for reduced motion never see movement.

On: the hero plays its animation (Hero motion below picks how). Off: the still poster only, with no animation script or frames downloaded. Shoppers who ask for reduced motion always get the still poster.

How themes with an animated hero play it. Shoppers who ask for reduced motion always get the still poster.

Paste the full address of each profile

Chooses which legal notes print. United States prints the US wording; the other two add the EU and UK notes. Review every note with counsel for your jurisdiction.

Prints “Prices exclude tax and shipping unless shown.” under the product price. Turn on only if your prices are shown without tax.

Printed in the footer as “Operated by”. Use your registered business name.

Linked next to forms and the age check. Blank uses the privacy policy from Settings > Policies.

Adds an accessibility statement link to the footer. Blank hides it.

Days before each renewal that you email the member. 0 states nothing. Set it only if you really send the reminder.

Days a shopper has to report a damaged or wrong food order. 0 states nothing.

Centered puts the wordmark over the middle and turns on quiet text actions on product cards; Split puts it at the start.

The whole message becomes a link.

Up to 24 products, shown as menu rows.

Saved on every line as the hidden property _box so the cart and an offer app can group them. Blank uses the heading.

Only when an offer app really applies one. The theme never computes a discount.

Statement: one large sentence. Plate: a wide image. Split: prose beside a tall image. Pinned steps: steps beside a sticky image (from 900 px wide, with motion on). Numbers: up to four stats.

Short name after Chapter N and in the chapter rail. Defaults to the heading.

The chapter is hidden, and not numbered, while the heading is empty.

Shown beside the steps of the pinned layout.

Buttons that link to #story (or the word you type here) jump to this chapter.

Shown before the heading, like 01. Leave blank to hide it.

Defaults to /pages/appointment, the page that uses the appointment template.

Only a promise you keep, like We reply within one business day. Blank shows nothing.

Add app snippets or other code

Lets search engines read these questions and answers

Defaults to the blog title.

Give one blog its own layout with an alternate blog template.

Shown before the heading, like 01. Leave blank to hide it.

The product option shown as cards with each pack’s price and saving, like Pack or Size. Other options stay as buttons.

Up to four. Checked add-ons go to the cart together with the product, in one request. Sold-out ones are left out.

A sold-out variant shows an email form that adds the shopper to your customers with the tag waitlist. Launch news is a separate, unticked checkbox.

Buttons that link to #buy (or the word you type here) scroll to this section.

Numbers this section with the chapters and uses the label as its title. The buy form stays the same.

The newest 50 articles of this blog. Lead: a pinned story, else the newest with the lead tag, else the newest.

Read by screen readers; defaults to the blog title.

The newest article with this tag leads the page.

Two lines are kept for it under the lead story, with or without text, so the page never shifts.

Auto: split with the split header (Mica), overlay otherwise. Overlay puts the copy on the dark scheme’s scrim over the image, never straight on the photograph.

A campaign still, 2400 × 1500, under 140 KB at 1600 px, the subject in the left or lower two thirds. It is the LCP image.

Use H1 only for the first hero of the page

Shown instead of the service line while it is filled. Say when it ends.

Transparent PNG or WebP with 8 to 10 px of padding.

One image with every frame in a grid, left to right and top to bottom. Without an atlas the hero plays Layers.

The schema.org type of every location’s structured data.

A picture of the map, 4:3, about 1200 px. No embedded map: every address is text.

Optional: a booking tool. The form stays as the way to write.

Short name after Chapter N and in the chapter rail. Defaults to the heading.

A map, plan or drawing at 3:2. Every place is also listed as text beside it.

Describes the whole map for screen readers. Defaults to the image alt text.

Defaults to the product of the page.

Shown before the heading, like 01. Leave blank to hide it.

Leave empty to use the first collection of the product.

Shown before the heading, like 01. Leave blank to hide it.

Short name after Chapter N and in the chapter rail. Defaults to the heading.

Shown until the shopper presses play. YouTube and Vimeo load only then.

For Shopify-hosted videos: link to a WebVTT (.vtt) file uploaded in Content > Files. YouTube and Vimeo use their own captions.

Language code, like en or de. Defaults to the store language.

A text version of the video for shoppers who cannot watch or hear it.

Turns on the table of contents, reading time and progress bar below. Off hides all three.

Built from the h2 headings of the story; shown with three or more.

0 places it 40 % of the way in. Never before paragraph 3, at most one promotion per 600 words.

Articles tagged members show two paragraphs to readers without the customer tag member. The full text stays in the page for search engines, marked as paywalled. Check your caching before you turn it on.

Give one blog its own layout with an alternate blog template.

Links with nested links become columns headed by the link title.

The header stays at the top of the screen while shoppers scroll.

Appears only when the store sells in more than one country or language.

For a front page whose lead story changes every day: the shop name becomes the h1, the lead story an h2.

A menu shown under the header on small screens, scrolling sideways.

PO number, the company’s terms read only, the tax line and Request a quote for this cart.

Gallery: large images in an editorial rhythm, for small catalogs. Grid: dense, for more than 24 products.

Catalog: table, list and grid views, filters in a sidebar or drawer, compare and one quantity control per row.

The table view shows more rows than the cards (36 by default).

A 64 px square image per row, loaded lazily from the fifth row. Off by default: food is chosen by reading.

A tile with an image and a link inside the grid on the first page, for example a room or a lookbook. Edit it in the Feature tile block.

A tile on its own color scheme with a heading and a button, on page 1 at the chosen position. It spans two cards and is never counted as a product.

Hidden for products sold with subscriptions, which need the regular checkout.

Shop Pay Installments, when the store offers it.

Off: the one-time purchase is chosen and the shopper picks a plan. On: the first monthly plan is chosen. The renewal terms always show inside the purchase options.

A sold-out variant shows an email form that adds the shopper to your customers with the tag waitlist. Launch news is a separate, unticked checkbox.

Shown under the button of a pre-order. [date] becomes the ship date. Leave blank for: Ships on or after [date]. You are charged today. Pre-order needs a ship date (product metafield custom.ship_date) with continue selling at zero stock, or a pre-order selling plan.

Used when the product metafield custom.fulfillment is blank: delivery, pickup, shipping. Delivery needs delivery_zone entries; pickup needs a location with local pickup.

A regular expression; the default ^[0-9]{5}$ takes five digits.

Weekday numbers from 1 (Monday) to 7 (Sunday), separated by commas.

HH:MM in the shop’s time zone. After it, the first pickup day moves one day later.

The Shopify account component offers sign-in without leaving the store.

Adds an "All ..." link at the top of the panel.

Up to four. Checked add-ons go to the cart together with the product, in one request. Sold-out ones are left out.

Leave empty to say whether prices include tax, or that the company is tax exempt.

Use two photos with the same crop, light and ratio.

For example the duration: 8 weeks of daily use.

One per line as Name: value, for example Width: 210 cm. Shown as a list of terms, so the numbers stay readable and translatable when a diagram image shows them too.

One row per line, cells separated by |. The first row heads the columns and the first cell of each row names it, for example Size | Chest | Waist, then S | 86–91 cm | 71–76 cm.

One row per line, cells separated by |. The first row heads the columns and its second cell is your product; the first cell of each row names the feature.

A cell with exactly this word also gets a check icon.

Defaults to /pages/appointment, the page that uses the appointment template.

Blank uses the product metafield custom.ingredients.

Shown with the date the product was last updated. Your wording: check it against the labelling rules where you sell.

Baked on, Roasted on, Picked on. The date comes from the product metafield custom.batch_date; custom.best_within_days adds the best-by date.

Storage, or a promise you keep, like Baked every morning.

Each image opens in a full screen view with zoom buttons and keys. There is no hover zoom.

Give the image a real alt text in Files.

One x, y pair in percent per line, in the order of the products, for example 30, 40.

Shown in a disclosure under the tiles.

Shows "Only N left" at or below this quantity. Only for variants whose inventory Shopify tracks.

Up to three. A product’s metafield custom.complete_the_look (product list) wins.

Leave blank for the style’s own heading.

One per line: Label | amount | % Daily Value, or Label | per 100 g | per serving. Reserved: Serving size | …, Servings | …, Calories | …. A leading - indents a row. Blank uses the product metafield custom.nutrition.

One per line: Label | value. Blank uses the product metafield custom.origin.

The product option shown as cards with each pack’s price and saving, like Pack or Size. Other options stay as buttons.

The option whose values are shades. Each variant needs the metafields shade.depth (1 to 10) and shade.undertone (warm, cool or neutral).

Defaults to /pages/appointment, the page that uses the appointment template.

A size_table metaobject; a product’s metafield custom.size_table wins. See the theme README.

Defaults to /pages/appointment, the page that uses the appointment template.

One per line as Name: value, for example Width: 210 cm. Shown as a list of terms, so the numbers stay readable and translatable when a diagram image shows them too.

One row per line: Label|namespace.key, like Thread|specs.thread. Rows the product has no value for are left out.

One step per line as Title: text, for example Apply: Two drops on damp skin. Connect a multi-line text metafield for steps per product.

Keep it on in only one steps block per template.

Shows "Only N left" at or below this quantity. Only for variants whose inventory Shopify tracks.

A real dispatch cut-off, like "Order by 2:00 PM CT for same-day dispatch". Empty uses the shop metafield depot.cutoffs.

A product’s metafield custom.warranty wins. Leave empty to hide the row.

Shown under the return window from Theme settings.

One Quantity: price per line, for example 3 to 5: $10.50. The variant’s quantity price breaks win.

Option names, separated by commas (for example Ring size). They start unselected, and Add asks for them instead of guessing.

The name of an option whose values run from light to dark (Roast): five bars and the value in words beside it.