Customize
Product pages
Product pages use the Product information section. Open it in the theme editor by choosing Products > Default product in the page selector.
In the Duskline preset, the default product template contains these blocks, in order: Vendor (hidden), Title, Product rating, Price, Variant picker, Size guide, Inventory status, Buy buttons, Delivery estimate, Description, two Collapsible rows and Complementary products. A Product recommendations section and a Collapsible content section follow below. The Gilt and Rally presets start with a different selection. See Presets.
Section settings
- Color scheme
- Default: Scheme 1.
Media
- Desktop layout
- Large first image, then two columns, Stacked, Two-column grid or Carousel with thumbnails. On mobile, media is always shown in a swipeable carousel.
- Desktop media width
- Small, Medium or Large.
- Desktop media position
- Left or Right.
- Desktop thumbnail position
- Below the media or Beside the media. Applies to the carousel with thumbnails layout.
- Enable sticky media on desktop
- Keeps the media in view while the product information scrolls, when the media is the shorter side.
- 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.
- Enable image zoom
- Selecting an image opens all product images in a full-screen lightbox. See Gallery, zoom and sticky media.
- Badge on first image
- A short note over the first image, for example the model's height and size. Connect a product metafield to show a different note per product. Leave empty to hide it. See Badge on first image.
- Hide other variants' media after selecting a variant
- On by default. The gallery shows only the selected variant's images (from its variant image up to the next variant's image) plus images not attached to any variant.
- Use the full screen width
- On large screens the gallery and details spread to the edges of the screen, instead of staying inside the page width.
Product information
- Enable sticky content on desktop
- The product information column stays in view while shoppers scroll through the images.
- Show sticky add to cart bar
- A bar with the product, a variant select and an add to cart button appears when the main add to cart button scrolls out of view. Requires a Buy buttons block. See Sticky add to cart.
Badges
- Badges from product tags
- Pairs of a product tag and the badge text, separated by commas. For example:
new: New in, eco: Recycled fabric. See Badges. - Show a New badge after publishing for
- Days since the product was published. Set to 0 to hide the badge.
Section padding
- Top padding, Bottom padding
- 0px to 100px. Default 36px.
The selected variant's image is shown first. Choosing a variant moves to its image.
Badge on first image
The badge is a short line of text shown over the first product image, such as "Model is 5'9" and wears size S". It shows on images only, not on videos or 3D models.
To show a different note on each product:
- In your admin, go to Settings > Custom data > Products and add a metafield definition, for example "Model note", of type Single line text.
- Fill the metafield on each product. Products without a value show no badge.
- In the theme editor, select the Product information section. Next to Badge on first image, select the Connect dynamic source icon and choose your metafield.
Gallery, zoom and sticky media
- Thumbnail position. With the Carousel with thumbnails layout, Desktop thumbnail position puts the thumbnails Below the media as a row or Beside the media as a column. On mobile, media is always a swipeable carousel.
- Sticky gallery. Enable sticky media on desktop keeps the media in view while a long product information column scrolls. It applies when the media is the shorter of the two sides. Enable sticky content on desktop does the opposite: it keeps the product information in view while shoppers scroll through a tall gallery.
- Mobile peek. Show part of the next media on mobile shows the edge of the next image in the mobile carousel, so shoppers can tell there are more photos.
- Lightbox zoom. With Enable image zoom on, selecting a product image opens a full-screen lightbox with every product image. Shoppers swipe or scroll sideways between images and close it with the close button or the Esc key. The lightbox shows images at a large size; videos and 3D models play in the gallery, not in the lightbox.
Badges
Badges show above the product title, up to 3 at a time. They come from two section settings and are separate from the sale and sold out badges of the Price block.
Badges from tags
- In your admin, add a tag to the products that should get the badge, for example
eco. - In the Product information section, enter the tag and the text to show in Badges from product tags, separated by a colon:
eco: Recycled fabric. - Add more pairs separated by commas:
new: New in, eco: Recycled fabric, gift: Gift idea.
- Tags are matched without regard to upper and lower case. The tag itself is never shown, only the badge text.
- When a product matches more than 3 pairs, the first 3 in your list show. The New badge, when it applies, counts as one of the 3 and comes first.
- Because a comma separates pairs and a colon separates tag and text, neither can be used inside a tag or a badge text.
New badge by date
Set Show a New badge after publishing for to a number of days. Each product then shows a "New" badge for that many days after it was published to your online store, and the badge goes away on its own. The date is real: there is no way to show the badge on older products with this setting. To mark an older product as new, use a tag badge instead.
These badges show on the product page and in the Featured product section. Product cards show the sale and sold out badges from Theme settings > Badges.
Sticky add to cart
With Show sticky add to cart bar on, a bar appears when the main add to cart button scrolls out of view, and hides again when the footer comes into view or a dialog such as the cart drawer or the size guide opens.
- On desktop, it is a floating bar centered at the bottom of the screen. On phones, it is a bar docked to the bottom with the photo, title, price and an add button.
- Products with variants get a variant select in the bar. Choosing a variant there also updates the variant picker, price and photos on the page.
- The bar's button adds the same thing as the main button: the quantity, the purchase option of a subscription and the gift card recipient fields are all respected.
- The bar needs a Buy buttons block in the template.
Blocks
- Text
- Text and Text style: Body, Subtitle or Uppercase.
- Title
- The product title, with Heading size: Small, Medium or Large. On the product page, the title is the page's main heading.
- Price
- Show sale and sold out badges. Shows the unit price when set, and a taxes included note when your prices include tax. Add a shipping policy in your store settings to link to it.
- Variant picker
- See Variant picker and swatches.
- Buy buttons
- Show quantity selector (off by default); Show dynamic checkout buttons (using the payment methods available on your store, customers see their preferred option, like PayPal or Apple Pay); Show recipient information form for gift cards. Also shows purchase options for subscriptions, the Shop Pay Installments message and pickup availability.
- Description
- The product description. Show in a collapsible row puts it in an expandable row.
- Collapsible row
- Heading; Icon; Row content (connect a product metafield to show different content per product); Row content from page; Open by default.
- Size guide
- See Size guide. One per product template.
- Material details
- See Material details. One per product template.
- Delivery estimate
- See Delivery estimate.
- Complementary products
- See Complementary products.
- Complete the set
- See Complete the set. One per product template.
- Back in stock request
- See Back in stock request. One per product template.
- Payment icons
- See Payment icons, trust list and specifications.
- Trust list
- See Payment icons, trust list and specifications.
- Specifications table
- See Payment icons, trust list and specifications.
- Share
- Label. Copies the product link, or opens the device share menu where available.
- Custom Liquid
- Add app snippets or other Liquid code to create advanced customizations.
- Icons with text
- Layout (One line with plus signs, Horizontal or Vertical) and up to three icons, each with an Icon and Text. Icons include garment shapes such as a shirt, pants, a robe and a dress. An item with empty text is hidden.
- Product rating
- Shows the rating saved by a product reviews app in the standard
reviews.ratingmetafield. Nothing shows when a product has no rating. - Inventory status
- Shows real stock levels for variants whose inventory Shopify tracks. Nothing shows for untracked variants. Low inventory threshold (1 to 50, default 10): at or below this number, shows how many are left. Show in stock message above the threshold. Variants that can be sold when out of stock show a backorder message.
- SKU
- The selected variant's SKU, when it has one.
- Vendor
- The product vendor.
- Apps
- App blocks from your installed apps.
Variant picker and swatches
The Variant picker block shows one group of choices per product option.
- Style
- Buttons or Dropdown, for options that are not shown as swatches.
Which options show as swatches
Options named in Theme settings > Product cards > Swatch option names, or options with swatches set in Shopify admin, show as color swatches. Swatches show regardless of the Style setting.
Each swatch takes its color from, in this order:
- The swatch image or color set for that option value in Shopify. How to set up swatches in Shopify.
- A color guessed from common color words in the value's name, such as "black", "sage" or "terracotta".
- A neutral swatch, an outlined shape with a diagonal line, when no color can be found.
The selected value's name is shown next to the option name. Sold out values stay selectable and are marked as sold out.
Options with one value
An option with only one value is not a choice, so it is shown as text, for example "Color: Sand", instead of a button or dropdown. When the option is a swatch option, a single swatch of that color is shown under the text so shoppers still see the color.
Changing variants without reloading
When a shopper chooses an option, the price, images, buttons, SKU, inventory status, delivery estimate and pickup availability update in place, and the page address changes to the selected variant so it can be shared.
Combined listings
If you sell each color as a separate product and group them with Shopify's Combined Listings app (available on Shopify Plus), Duskline shows the grouped products as one set of options. Choosing an option that belongs to another product swaps the product page in place and updates the address, without a full page reload. Product cards also link each swatch to its own product.
Size guide
The Size guide block adds a link with a ruler icon. It opens a dialog with your size chart and, optionally, a "how to measure" image beside it. On phones, the dialog slides up from the bottom of the screen, with the chart first and the image below.
- Link label
- Default: Size guide.
- Heading
- The dialog heading. When empty, the selected page's title is used.
- Show link beside option
- The link sits to the right of this option's label in the variant picker. Leave empty to show it where the block is placed.
- Note under the chart
- An optional short line under the chart.
- Size chart page
- A page that holds your size chart.
- Size chart
- Used when no page is selected. Tables from a page or a rich text metafield keep their layout.
- How to measure image
- Shown full height beside the chart at its own aspect ratio. Portrait images work best.
Size finder
- Show size finder
- Shoppers enter their measurements and the chart suggests the smallest size that covers them. The chart needs a table with sizes in the first column and numbers or ranges in the measurement columns.
- Measurements to ask for
- Chart column headings, separated by commas. For example: Bust, Hips. Leave empty to use the first two measurement columns.
Measuring points
- First label, Second label, Third label, Fourth label
- Add up to 4 numbered labels on the how to measure image. A label that matches a chart heading shows the same number in the chart.
- Horizontal position, Vertical position
- One pair per label. Positions are measured from the image's top left corner.
Contact
- Sizing help email
- Shows a contact line under the chart. Leave empty to hide it.
- Sizing help link
- Used when no email is set.
The link is hidden on your storefront when the block has no chart and no image. When the product has the option named in Show link beside option and the template has a Variant picker block, the link appears next to that option's label; otherwise it appears where the block is placed.
Three ways to add the chart
1. From a page (one chart for every product)
- In your admin, go to Online Store > Pages and create a page, for example "Size chart". Add a table with the editor's table tool.
- In the theme editor, select the Size guide block and choose the page in Size chart page.
2. In the block (one chart for every product)
Leave Size chart page empty and write the chart in Size chart.
3. From a product metafield (a chart per product)
- In your admin, go to Settings > Custom data > Products and add a metafield definition, for example "Size chart", of type Rich text.
- Fill the metafield on each product that needs its own chart.
- In the theme editor, select the Size guide block. Make sure Size chart page is empty.
- Next to Size chart, select the Connect dynamic source icon and choose your metafield.
When Size chart page has a page, that page is shown and the Size chart setting, including a connected metafield, is ignored. Clear the page to use the metafield.
Highlighting the selected size
When the chart is a table and its first column holds the size names (for example XS, S, M), the row that matches the shopper's selected size is highlighted when the dialog opens.
Inches and centimeters switch
When your chart has measurements in both units, the size guide shows an in / cm switch and displays one unit at a time. To turn it on, end the column headings with the unit in parentheses: (in) for inches and (cm) for centimeters. The chart needs at least one column of each.
| Size | Bust (in) | Bust (cm) | Hips (in) | Hips (cm) |
|---|---|---|---|---|
| S | 33.5 - 35 | 85 - 89 | 36 - 37.5 | 91 - 95 |
| M | 35.5 - 37 | 90 - 94 | 38 - 39.5 | 96 - 100 |
- With the switch, the headings are shown without the unit ("Bust", "Hips") and only the columns of the selected unit are visible.
- Shoppers in the United States, Liberia and Myanmar see inches first. Everyone else sees centimeters first. Shoppers can change the unit at any time.
- Headings that end in
(inch)or(inches)also count as inches. - A chart with only one unit, or with no units in its headings, is shown as you wrote it, without a switch.
Size finder
With Show size finder on, the size guide shows a "Not sure of your size?" link above the chart. It opens a small form with one field per measurement. As the shopper types, the size guide suggests a size, highlights that row of the chart and offers a button to select the size on the product page.
- What the chart needs. A table with the size names in the first column and numbers or ranges, such as
89or85 - 89, in the measurement columns. The finder reads the first table of the chart. Columns without numbers, such as notes, are skipped. - Which measurements are asked for. By default, the first two measurement columns. To choose, enter the column headings in Measurements to ask for, separated by commas and without the unit, for example
Bust, Hips. - How the size is chosen. The finder suggests the smallest size whose values cover every measurement the shopper entered. For a range, the highest number is the limit. When the measurements point to different sizes, the larger size is suggested with a note that it gives more room. When a measurement is above your largest size, the finder says so instead of suggesting a size.
- Units. With the inches and centimeters switch, the fields use the selected unit, and values the shopper already entered are converted when the unit changes.
The finder is not shown when the chart has no table. Turn Show size finder off to hide it for every product.
Measuring points
Measuring points are up to 4 numbered labels placed on the How to measure image, for example 1 Bust, 2 Waist, 3 Hips.
- Add a How to measure image.
- Under Measuring points, type a label in First label and move it into place with Horizontal position and Vertical position. Positions are measured from the image's top left corner.
- Repeat for up to four labels. A label left empty is not shown.
When a label has the same text as a chart column heading, such as "Bust", that heading shows the same number, so shoppers can connect the photo to the chart.
Material details
The Material details block adds a link that opens a dialog with a photo and short facts such as fabric and care. The dialog shows the product title, your heading, up to four rows with a label and a value, and optional body text. On phones it slides up from the bottom of the screen, with the text first and the photo below.
- Link label
- Default: Material.
- Icon
- Fabric, Leaf, Sparkle, Info or None.
- Show link beside option
- The link sits to the right of this option's label in the variant picker. Leave empty to show it where the block is placed.
- Heading
- The dialog heading.
- Image
- Shown full height beside the text at its own aspect ratio. Portrait images work best.
First row, Second row, Third row, Fourth row (one group each)
- Label
- The name of the fact, such as "Material" or "Care".
- Text
- The value. Rows without text are hidden.
Body text
- Body text
- Optional text under the rows.
The link is hidden on your storefront when the block has no row text, no body text and no image. If the size guide and the material details are set to sit beside the same option, the size guide link is shown there and the material link appears where its block is placed.
Show different details per product
Each Text setting and the Body text setting can be connected to a product metafield as a dynamic source.
- In your admin, go to Settings > Custom data > Products and add a metafield definition for each fact, for example "Material" and "Care", of type Rich text.
- Fill the metafields on your products.
- In the theme editor, select the Material details block. Next to the Text setting of a row, select the Connect dynamic source icon and choose the matching metafield.
- Repeat for the other rows.
A row whose metafield is empty on a product is hidden for that product, so you can connect rows that only some products use.
Delivery estimate
The Delivery estimate block shows an estimated delivery date range, for example "Arrives Tue, Nov 18 – Thu, Nov 20". Set the days, order cutoff time and holidays in Theme settings > Delivery estimate.
- Show icon
- A truck icon before the dates.
- Note
- Optional short line under the dates.
First detail, Second detail (one group each)
- Title
- Shown under the delivery dates. Leave empty to hide it.
- Text
- A short line for the detail, for example your returns window.
- Link label, Link
- An optional link for the detail, for example to your shipping policy.
How the dates are calculated
- The ship day is today, in your store's time zone. If it is past the Order cutoff hour, or today is not a business day, the ship day moves to the next business day.
- The earliest date is Minimum business days business days after the ship day. The latest date is Maximum business days business days after it.
- Business days skip Saturdays and Sundays when Skip weekends is on, and skip every date listed in Holidays.
When both numbers give the same day, a single date is shown. Dates are written in the shopper's language. The estimate is hidden for sold out or unavailable variants, and it is calculated in the shopper's browser so cached pages never show old dates.
The same settings are used by the delivery estimate in the cart. See Cart.
Use the delivery times your carriers actually achieve. The estimate is a guide for shoppers, not a guarantee, and it does not read your shipping rates.
Pickup availability
When local pickup is set up, the Buy buttons block shows whether the selected variant can be picked up and where. Nothing shows for products without pickup locations. There is no setting to turn on: set up local pickup in your admin under Settings > Shipping and delivery > Local pickup.
Shop Pay Installments
When Shop Pay Installments is available for your store and the product's price is eligible, a message about paying in installments appears under the buy buttons. It is shown automatically by Shopify; there is no theme setting. Manage it in your admin under Settings > Payments.
Complementary products
The Complementary products block shows products that go well with the current one, in a horizontal row with arrows. Each has a quick add button.
- Heading
- Default: Pairs well with.
- Maximum products to show
- 1 to 10. Default 4.
To select complementary products, add the Search and Discovery app, open a product in the app's Product recommendations page and add complementary products. The block stays hidden for products that have none.
Complete the set
The Complete the set block shows this product with up to 4 companion products. Customers tick the ones they want and add them all to the cart with one button. Each companion has its own variant select and price, and a total updates as boxes are ticked.
- Heading
- Default: Complete the set.
- Button label
- Default: Add selected to cart.
- Products
- Chosen below uses the four product settings of the block. Complementary products uses the complementary products set per product in the Search and Discovery app.
- Select companion products by default
- When on, companions start ticked. When off, customers tick the ones they want.
- First product, Second product, Third product, Fourth product
- The companion products, used when Products is Chosen below.
Prices are the products' own prices; no discount is applied, and the products are added to the cart as separate lines. To give a discount for buying products together, create an automatic discount in your Shopify admin; the block does not announce it.
- With Chosen below, the same companions show on every product that uses the template. To show different companions per product, choose Complementary products, or connect the product settings to product metafields.
- Companions that are sold out, gift cards and the product being viewed are left out. The block is hidden when no companion is left.
- In the theme editor, an empty block shows a note asking you to choose products.
Back in stock request
The Back in stock request block shows a short email form when the selected variant is sold out. It is hidden while the variant can be bought.
- Heading
- Default: Email me when this is back.
- Text
- Default: Leave your email and we will write to you when it is back in stock.
- Button label
- Default: Notify me.
Each request is sent to your store's contact email through Shopify's contact form, with the customer's email, the product, the variant, the SKU and a link to the product. Duskline does not keep a waiting list and does not send an email when you restock. When the product is back, you write to the customers who asked. For automatic back in stock emails, use an app from the Shopify App Store.
- Requests arrive at the sender email set in your admin under Settings > Notifications, like messages from your contact page.
- Because the form uses Shopify's contact form, Shopify may show its spam check to some visitors.
- Leaving an email here does not subscribe the customer to marketing.
Payment icons, trust list and specifications
Payment icons
Shows the payment methods enabled in your store's payment settings. The icons come from Shopify, so the block always matches what your checkout accepts.
- Heading
- Leave empty to show the icons alone.
- Show icons in grayscale
- Shows the icons without color for a quieter look.
Trust list
Up to 4 rows with an icon, a heading and a short text, for points such as shipping, returns and secure checkout. Rows without a heading and text are hidden.
- Show lines between rows
- Default: on.
- Icon, Heading, Text
- One group for each of the four rows.
The default headings are examples. Change or remove them so that every line is true for your store.
Specifications table
Up to 8 rows with a label and a value, for details such as fabric, weight or dimensions. Rows without a value are hidden.
- Heading
- Default: Specifications.
- Rows shown on mobile
- On mobile, the other rows open with a Show all button.
- Label, Value
- One pair for each of the eight rows. Connect a value to a product metafield to show it per product.
To show different specifications on each product, create product metafields in Settings > Custom data > Products, then select the Connect dynamic source icon next to each Value. A product with no value for a row does not show that row.
Gift cards
Gift card products use the same product page. With Show recipient information form for gift cards on in the Buy buttons block, shoppers can tick a box to send the gift card to someone else by email, with a recipient name, a message and a send date.
The page customers see after receiving a gift card shows the amount, the code with a copy button, a QR code, the remaining balance and expiry date when set, an Add to Apple Wallet button and a print option. It uses your theme fonts, with color scheme 1 for the page and color scheme 3 for the gift card illustration.