Duskline Theme docs

Help

Frequently asked questions

Quick answers to the questions merchants ask most. Can't find yours? Contact support.

Before you edit theme code

Always duplicate your theme first: in Online Store > Themes, open the theme's menu and select Duplicate, then edit the copy. Code changes are not covered by Duskline support and are not carried over when you update the theme. For custom work, we recommend hiring a Shopify Partner.

Hero and design

How do I change when the hero switches between day, dusk and night?

Select the Time of day hero section and change Day starts at, Dusk starts at and Night starts at. Hours use the 24-hour clock, so 17 means 5 PM. Night lasts until Day starts at the next morning.

The phase follows the clock on each visitor's own device, so a visitor in Tokyo and a visitor in London can see different phases at the same moment.

Why does the hero show a different phase than I expect in the theme editor?

In the editor, the hero follows Preview phase in the editor. Set it to Day, Dusk or Night to check each phase while you work, or to Visitor's local time to see what a visitor on your computer would see. This setting never affects visitors.

Do I need three hero images?

No. A phase without its own image or video uses the day image and video. You can use one image and still let the eyebrow and color scheme change through the day.

I added a video to the hero. Why is my image no longer shown?

While a phase has a Video, the hero shows the video's own first frame until the video starts, so the picture does not change when playback begins. The phase's Image and Mobile image are not used. To choose what visitors see first, make it the first frame of your video.

Visitors who prefer reduced motion, use a data saver or are on a very slow connection see that first frame as a still image. More about video in the hero.

Can the hero video play with sound?

Videos always start muted, because browsers do not allow sound before a visitor asks for it. If your video has sound, turn on Show sound button in the Time of day hero section. Visitors then get a button to turn the sound on and off, next to the pause button.

How do I switch between the Duskline, Gilt and Rally presets?

In the theme editor, open Theme settings > Theme style, select Change theme style and choose a preset. This replaces your theme settings, such as colors and fonts, and keeps the sections on your pages. To start from a preset's page layouts, add the theme from the Theme Store with that preset selected. Duplicate your theme before you switch. More about switching presets.

How do I make the header transparent over the hero?
  1. Place a Time of day hero or Image banner as the first section on your home page, and turn on its Use header overlay setting.
  2. In the Header section, turn on Use transparent header on home page.
  3. Add an Inverse logo in Theme settings > Logo, so a light logo shows over the image.

The transparent header is used on the home page only.

Products and swatches

Why are some swatches empty instead of showing a color?

A swatch is neutral, an outlined shape with a diagonal line, when Duskline can't find a color for that option value. Colors are found in this order:

  1. The swatch color or image set for the option value in Shopify.
  2. A common color word in the value's name, such as "black", "sage", "navy" or "terracotta".
  3. Otherwise, a neutral swatch.

Names like "Midnight" or "Fig" don't contain a known color word, so they show a neutral swatch. To fix it, set a swatch color or image for each value in Shopify: open the product, edit the option, and choose a swatch for each value. Shopify's guide to swatches.

Why don't swatches show on my product cards?

Check these in order:

  • Theme settings > Product cards > Show color swatches is on.
  • The option's name is listed in Swatch option names. The default list is "Color, Colour, Print, Pattern". If your option is called something else, such as "Shade", add it to the list.
  • The product has at least two values for that option.

To make the card's photo change when a swatch is selected, add an image to each variant.

How do I connect a metafield to the size guide?
  1. In your admin, go to Settings > Custom data > Products and add a definition of type Rich text, for example "Size chart".
  2. Fill in the metafield on your products.
  3. In the theme editor, select the Size guide block. Clear Size chart page.
  4. Next to Size chart, select Connect dynamic source and choose the metafield.

A selected page always takes priority over the Size chart setting, so the page must be empty for the metafield to show. More about the size guide.

How do I get the inches and centimeters switch in the size guide?

Give your size chart a column for each unit and end the column headings with (in) and (cm), for example "Bust (in)" and "Bust (cm)". The size guide then shows one unit at a time with a switch. A chart with only one of the two units is shown as written, without a switch. More about the unit switch.

Why doesn't "Not sure of your size?" show in my size guide?

Check that Show size finder is on in the Size guide block, and that your chart is a table with size names in the first column and numbers or ranges, such as 85 - 89, in the measurement columns. If you filled in Measurements to ask for, the names must match your column headings, without the unit. More about the size finder.

How do I show different material and care details on each product?

Add a Material details block to your product template, create a product metafield for each fact, such as "Material" and "Care", and connect each row's Text setting to its metafield with Connect dynamic source. Rows without a value are hidden. More about material details.

How do I hide the delivery estimate?

In the theme editor, open your product template, select the Delivery estimate block and select the eye icon to hide it, or remove the block. To hide it on some products only, create an alternate product template without the block and assign it to those products in their product details.

The estimate is also hidden automatically for sold out and unavailable variants.

How do I stop the delivery estimate counting holidays?

Add each date to Theme settings > Delivery estimate > Holidays, one per line, in the format YYYY-MM-DD, for example 2026-12-25. Those dates are skipped both as ship days and as delivery days. Update the list each year.

Why don't complementary products show?

Complementary products come from the Search and Discovery app. Install the app, open Product recommendations, choose a product and add complementary products. The product page block stays hidden for products with none. In the cart, Duskline falls back to Shopify's automatic related products when none are set.

Store setup

Does the free shipping progress work with multiple currencies?

Yes. Enter Free shipping threshold in your store's default currency. In the cart, the threshold is converted to the shopper's currency with the current exchange rate.

Two things to know: the converted amount follows the exchange rate, not market rounding, and the [free_shipping_threshold] placeholder in the announcement bar is not converted. If you sell in several currencies, avoid the placeholder or word the announcement without an amount.

How do I translate the theme or change its text?

Duskline's storefront text, such as "Add to cart" and cart messages, comes in English, French, German, Spanish, Italian, Brazilian Portuguese, Dutch, Japanese and Danish. To change any of it, go to Online Store > Themes, open the theme's menu and select Edit default theme content, then choose the language to edit.

To sell in other languages, add and publish them in Settings > Languages. For the languages listed above, the theme's text is already translated. For any other language, and for your own content such as products, pages and the text you typed in the theme editor, use Shopify's free Translate and Adapt app. Turn on Show language selector in the header, footer or announcement bar so shoppers can switch.

How do I update Duskline to a new version?

When an update is available, Shopify shows a notice on the theme in Online Store > Themes. Choose to add the updated version to your theme library. Shopify adds it as a new, unpublished theme with your theme editor settings carried over. Preview it, then publish it when you are happy.

Changes you made to theme code are not carried over. If you edited code, note your changes before updating, or ask your developer to reapply them. See the changelog for what changed.

Can you add a custom feature or change the code for me?

Custom code is not part of Duskline support. We fix bugs and answer questions about the theme's features and settings. For custom work, hire a Shopify Partner, and make sure they work on a duplicate of your theme. See the support policy.

Will my apps work with Duskline?

Duskline supports app blocks and app embeds. Add app blocks with the Apps section, or directly in the Product information and Featured product sections. Turn on app embeds in the theme editor under App embeds. For problems inside an app, contact the app's developer.