Duskline Theme docs

Customize

Collections and search

How shoppers browse: collection pages, visual filters, sorting, pagination, promo tiles, product cards with swatches, quick add and search.

Collection page

Collection pages use the Collection section. In the theme editor, choose Collections > Default collection in the page selector.

Banner

Show eyebrow text above the heading
Shows the word "Collection" above the collection title.Default: off.
Show collection description
Shows the description you wrote for the collection.
Collapse long descriptions
Shows the first lines with a "Read more" link.Default: off.
Show collection image
Add an image in the collection details in your Shopify admin.Default: off.
Image layout
Beside the text or Behind the text.Default: Beside the text.
Fallback image
Shows when a collection has no image.
Banner height
Small, Medium or Large. Shown when the image is behind the text.
Text alignment
Left or Center. Shown when the image is behind the text.
Make banner full width
Spreads the banner to the edges of the screen. Shown when the image is behind the text.
Banner color scheme
Sets the text and overlay colors over the image.Default: Scheme 3.
Overlay opacity
How strongly the image is tinted so the text stays readable.0% to 90%. Default 35%.

Subcollection links

Menu
Shows a row of links below the banner. When the current collection is in this menu and has nested links, those links show instead.
Link style
Text or Collection image and text.

Product grid

Products per page
8 to 36. Default 24.
Columns on desktop
2 to 5. Default 4.
Columns on mobile
1 column or 2 columns.
Let customers change the number of columns
The columns above are the default. A customer's choice is remembered on their device. See Grid density switch.Default: on.

Pagination

Pagination
Page numbers, Load more button or Infinite scroll. See Pagination.Default: Page numbers.
Pages loaded automatically
Shown for infinite scroll. After this many pages, customers continue with a Load more button so the footer stays reachable.1 to 5. Default 2.

Filtering and sorting

Enable filtering
Shows filters. Customize filters with the Search and Discovery app.
Filter layout on desktop
Horizontal, Vertical or Drawer. Filters always open in a drawer on mobile. See Filter layouts.
Keep the filter bar visible while scrolling
The bar with filters, sorting and the product count stays at the top of the screen while shoppers scroll.Default: off.
Enable sorting
Shows the sort menu.

Section padding

Color scheme, Top padding, Bottom padding
Colors and spacing of the section.

The banner at the top of a collection page shows the collection title, and optionally an eyebrow, the description and an image.

  • Image beside the text. With Show collection image on and Image layout set to Beside the text, the image sits next to the title and description.
  • Image behind the text. With Behind the text, the image fills the banner and the text sits on top. Choose the Banner height, Text alignment, Banner color scheme and Overlay opacity, and turn on Make banner full width to run it edge to edge.
  • Collections without an image. Choose a Fallback image so every collection gets a banner image, even when it has none of its own in your admin.
  • Read more. With Collapse long descriptions on, a long description shows its first lines followed by a "Read more" link that opens the rest, and a "Read less" link to close it. Short descriptions are shown in full with no link. The full text stays in the page, so it is still read by search engines and shown when JavaScript is off.

Subcollection links

A row of links under the banner helps shoppers move between related collections, such as from "Sleepwear" to "Pajama sets", "Robes" and "Nightdresses".

  1. In your admin, open Content > Menus and create a menu with links to the collections you want to offer. You can also reuse your main menu.
  2. In the Collection section, choose that menu in the Menu setting under Subcollection links.
  3. Choose a Link style: Text for a row of text links, or Collection image and text for round collection images with the title below.
  • When the collection being viewed is in the menu and has links nested under it, those nested links show. Otherwise the menu's top-level links show. This lets one menu serve every collection.
  • With Collection image and text, a link to a collection without an image shows the first letter of its title.
  • Shopify does not have real subcollections. These are menu links that you arrange; products are not combined between a collection and the collections linked under it.

Filtering

Duskline shows the filters that Shopify provides for each collection and search. Which filters appear, and in what order, is set in the free Search and Discovery app.

  1. Install the Search and Discovery app from the Shopify App Store.
  2. In the app, open Filters and select Add filter. Choose a source such as Availability, Price, Product type, Vendor, a variant option like Size or Color, or a metafield.
  3. Save. The filters appear on your collection pages and search results when Enable filtering is on.
  • Active filters appear as removable pills above the products, with a link to clear them all.
  • Results update as shoppers change filters, without reloading the page. Without JavaScript, filters still work as a normal form.
  • The number of products found is shown in the filter bar and announced to screen readers when it changes.
Filters not showing?

Check that Enable filtering is on, that filters are added in Search and Discovery, and that the collection has products with values for those filters.

Visual filters and price slider

Swatch and image filters

A filter shows its values as color swatches in either of these cases:

  • The filter is set to show as swatches in the Search and Discovery app.
  • The filter's name matches one of your Swatch option names in Theme settings > Product cards (default: Color, Colour, Print, Pattern).

Each swatch uses the color or image your store has for that value. You add this swatch data to your option values in your Shopify admin. How swatch colors are chosen. When a value has no swatch data, Duskline guesses a color from common color words in its name, and shows a neutral swatch if nothing matches. Every swatch keeps its name and product count next to it, so the filter never depends on color alone.

A filter set to show images in the Search and Discovery app shows each value's image. Values without an image show as text.

Price slider

When you add a Price filter in Search and Discovery, shoppers get a slider with two handles and a minimum and maximum price field. The slider runs from 0 to the highest price in the collection or search. Moving a handle updates the fields, and typing in a field moves the handle. Without JavaScript, the two fields work on their own.

Filter layouts and sticky filters

Filter layout on desktop has three choices:

LayoutWhat shoppers see on desktop
HorizontalA bar above the products. Each filter opens as a small panel under its name.
VerticalA sidebar beside the products. The first four filters start open, along with any filter in use.
DrawerA button that opens all filters in a panel from the side of the screen.

On screens narrower than 990px, filters always open in a drawer, whichever layout you choose.

With Keep the filter bar visible while scrolling on, the bar that holds the filters, the product count, the grid density switch and the sort menu stays at the top of the screen as shoppers scroll through products. With the Vertical layout, the sidebar also stays in view on desktop.

Sorting

With Enable sorting on, shoppers can sort by the options Shopify provides, such as featured, best selling, alphabetical, price and date. The default order of a collection is the sort order you choose for that collection in your admin under Products > Collections.

Pagination

The Pagination setting decides how shoppers reach more products than fit on one page. Products per page sets the size of each page in all three modes.

ModeHow it works
Page numbersNumbered links to each page under the grid. The default.
Load more buttonA button under the grid adds the next page of products below the ones already shown, with a note of how many products are showing.
Infinite scrollThe next page loads on its own as shoppers near the end of the grid. After the number of pages in Pages loaded automatically, shoppers continue with a Load more button so the footer stays reachable.
  • With load more and infinite scroll, the page address follows the page in view, so a shared link or the back button returns shoppers to where they were. A shopper who lands in the middle of a collection gets a button to load the previous products.
  • Visitors who prefer reduced motion get the Load more button instead of automatic loading.
  • Without JavaScript, the Load more button is a normal link to the next page.

Grid density switch

With Let customers change the number of columns on, a small switch in the filter bar lets shoppers choose how many products show per row: 2, 3 or 4 columns on desktop (and 5 when your Columns on desktop is 5), and 1 or 2 columns on mobile. Your Columns on desktop and Columns on mobile settings are the starting point.

A shopper's choice is saved in their browser and used on their next visits and on other collections and searches. It does not change what other shoppers see. Turn the setting off to keep everyone on your column settings.

Promo tiles

Add a Promo tile block to the Collection section to place a tile between products in the grid, for example to introduce a material, a fit or an offer. Up to 6 per collection template.

Position in grid
Where the tile appears among the products. The position counts products across all pages, so position 30 with 24 products per page puts the tile on the second page.1 to 48. Default 5.
Width
1 column or 2 columns.Default: 2 columns.
Image
The tile image.
Eyebrow text, Heading, Body text
The tile text.
Button label, Button link
Where the tile leads.Default label: Discover.
Text placement
Below image or Over image.
Color scheme
Default: Scheme 2.
Show in
Every collection or Selected collections only. Applies to collections that use this template.Default: Every collection.
Selected collections
Used when Show in is set to Selected collections only. If none is chosen, or a chosen collection was deleted or is not available in the online store, the tile is not shown anywhere.
  • Set Show in to Selected collections only to keep one template for all collections and still show a tile about robes only in your robes collection.
  • A tile whose position is past the last product shows at the end of the grid, on the last page.
  • Promo tiles are available on collection pages, not on the search results page.

Product cards and swatches

Cards are styled in Theme settings > Product cards, Badges and Swatches. See every card setting.

Photos

With Show second image on hover on, desktop shoppers see the product's second image when they hover a card, and touch screen shoppers can swipe through up to five images, with dots showing their place.

Swatches

With Show color swatches on, a card shows swatches for the first product option whose name is listed in Swatch option names (default: Color, Colour, Print, Pattern). Products with fewer than two values for that option show no swatches on the card. On the product page, a single color is still shown as one swatch. See Options with one value.

  • Selecting a swatch changes the card's photo to that variant's image and points the card's link to that variant. With combined listings, it points to the product for that color.
  • On desktop, hovering a swatch previews its photo.
  • Up to five swatches show; a "+3" style link leads to the product for the rest.
  • For the photo to change, add an image to each variant in your admin.
Card swatches use option names

On product cards, swatches show only for options whose name is in Swatch option names. If your color option has another name, such as "Shade", add that name to the list. Swatch colors come from your option values, as explained in Variant picker and swatches.

Badges

A sold out badge shows when no variant is available; a sale badge shows when the compare-at price is higher than the price.

Quick add

With Enable quick add on, each available product's card has a quick add button.

  • Products with a single variant are added to the cart in one tap.
  • Products with options open a small dialog to choose them, then add to the cart. For gift cards and products sold only by subscription, the dialog links to the product page.
  • After adding, the cart drawer opens, or shoppers go to the cart page when Cart type is Page.

The search icon in the header opens a search dialog. With Theme settings > Search > Enable search suggestions on, results appear as shoppers type: suggested searches, products, collections, pages and blog posts. Shoppers can move through suggestions with the arrow keys.

Show product vendor
Shows the vendor on product suggestions.
Show product price
Shows the price on product suggestions.

To change which products rank first or to add synonyms, use the Search and Discovery app.

Search results page

The full results page uses the Search results section. It shows products as product cards and also lists matching blog posts and pages.

Results per page
8 to 36. Default 24.
Columns on desktop
2 to 5. Default 4.
Columns on mobile
1 column or 2 columns.
Let customers change the number of columns
See Grid density switch.
Pagination, Pages loaded automatically
See Pagination.
Enable filtering, Filter layout on desktop, Keep the filter bar visible while scrolling, Enable sorting
Work the same as on the collection page.