Skip to content

Cascading product list

This guide describes setting up the Cascading product list section.

Use the section to display product media (items) on a store page, for a selection of products, arranged in a cascade layout. A cascade layout arranges items in columns. Inside a column, the items follow one after another to create a succession of items on a store page.

In the previous video, a Cascading product list section is displayed on a store's home page. On the right, in the section settings, the checkbox Feature full width products is set to on. This setting displays some of the product tiles (images) at full width inside the section.

For general guidance with modifying sections, refer to Sections overview and Shopify help: Sections and blocks.

Set up a cascading product list section

To set up a Cascading product list section:

  1. Go to Customize theme.

    In Theme editor, at the top of the page, use the dropdown to select a page that contains a Cascading product list section.

    Note

    The section can be added into any page, except Checkout and Giftcard pages. To add the section into the current page, select Add section > Cascading product list. Refer to Shopify help: Add a section.

  2. From the side menu, select Cascading product list.

    A Cascading product list section selected in Theme editor.

  3. Select a setting described in the following table.

Setting nameDescription
HeadingIn the Heading box, enter text to display as a heading (title) inside the section.
Heading > Insert dynamic sourceIf available, to display (heading) text from a dynamic source, if available, select the icon Insert dynamic source beside the Heading box, and then choose a metafield to add. Refer to Shopify help: Metafields.
ProductsUse the following Products selector options to set up a product inside the section.
  • To add a product, choose Select products, enter the name of a product into the Search box and/ or select a product from the list. Then, choose Select.
  • To create a new product, choose Select product > Create product to open the Add product page in Shopify admin. Select the new product, and then choose Select. Refer to Shopify help: Products.
  • To replace a product, choose Change > Change product, and then select or create a product.
  • To remove a product, select Change > Remove product.
Products > Connect dynamic sourceTo display products from a dynamic source, if available, select the icon Connect dynamic source beside the Products selector, and then choose a metafield to add. Refer to Shopify help: Metafields.
Show product image onlySelect the Show product image only checkbox to turn on/off "product image only" mode. With this setting enabled, only the product image (tile) is displayed for each item inside the section.
Layout > Feature full width productsSelect the checkbox Feature full width products to turn on/off displaying (product) tiles at full width inside the section. With this setting off, a mix of half width and full width tiles are displayed.
Layout > Enable cascade layout on mobileSelect the checkbox Enable cascade layout on mobile to show/hide the section's cascading content area on mobile displays.
Layout > Desktop layoutSelect the Desktop layout radio buttons to set a layout style for the section's cascading content area. The options are One column or Two columns. This setting applies to desktop display devices.
Cascade effect > Level of media size variationAdjust the Level of media size variation slider to apply more or less varied sizes to the media items displayed inside a cascading section. The slider ranges from 0 to 4. Select 0 for no size variation, to display all media at the same size. Select 4 to maximize the size variation.
Cascade effect > SequenceAdjust the Sequence slider to set how media items (tiles) are resized inside a cascading section. Inside a cascading section, tiles are resized according to a pattern or "sequence". Adjust the slider between 1 and 5 to specify a sequence.
Cascade effect > Alignment variationAdjust the Alignment variation slider to use more or less varied alignments to display media items inside a cascading section. The slider ranges from 1 to 7. Select 1 for minimally varied alignments. Select 4 for maximum alignment variation.
Cascade effect > Vertical space between itemsAdjust the Vertical space between items slider to set the amount of vertical space displayed between items inside a cascading section. The slider ranges from 0.5 to 2.
Cascade effect > Start positionUse the Start position options to specify a starting position for displaying the first item in a cascade layout. The options are Top left and Top right.
Cascade effect > Use global settingsSelect the Use global settings checkbox to turn on/off "global settings" mode. Enabling this option overrides all cascade effect settings you specified inside the section, and applies the "global" cascade effect settings you specified in Theme settings > Cascading content.
Heading overlay > Overlay headingSelect the Overlay heading checkbox to turn on/off overlaying the section's content with the section's heading text. The overlay remains in the section ("sticky") as the cascading content scrolls.
Heading overlay > Heading mobile font size scaleUse the Heading mobile font size scale slider to specify a size for overlaid heading text inside the section. This setting applies to mobile display devices. The slider ranges from -2 to 4. To use this setting, enable the section's Overlay heading option.
Heading overlay > Heading desktop font size scaleUse the Heading desktop font size scale slider to specify a size for overlaid heading text inside the section. This setting applies to desktop display devices. The slider ranges from -2 to 10. To use this setting, enable the section's Overlay heading option.
Heading overlay > Call to action linkIn the Call to action link box, enter a URL for the section's button to use or select a link to a store page. The button is displayed beside overlaid heading text inside the section. To use this setting, enable the section's Overlay heading option.
Heading overlay > Call to action link > Connect dynamic sourceTo display a link from a dynamic source, if available, select the Connect dynamic source icon beside the Call to action link box, and then choose a metafield to add. Refer to Shopify help: Metafields.
Heading overlay > Call to action labelIn the Call to action label box, enter text to display as label text for the section's "Call to action" button. To use this setting, enable the section's Overlay heading option, and add a link to the section's Call to action link box.
Heading overlay > Call to action label > Connect dynamic sourceTo display Call to action label text from a dynamic source, if available, select the Connect dynamic source icon beside the Call to action label box, and then choose a metafield to add. Refer to Shopify help: Metafields.
Heading overlay > Call to action styleUse the Call to action style options to apply a Solid or Border button style to the section's Call to action button. To use this setting, enable the section's Overlay heading option, and add a link to the section's Call to action link box. This setting defaults to Solid, if the section's Blend mode option is not set to Normal.
Heading overlay > Blend modeUse the Blend mode options to specify how the section's overlay heading text blends with the colors beneath it. Refer to Mozilla developer documentation: Mix blend mode examples. The options are Normal, Difference, Exclusion, Overlay, Soft light. Some blend modes work better when the text color is dark, others when it is light.
Heading overlay > Blend mode color schemeUse the Blend mode color scheme options to select a color scheme for the section's Blend mode effect. Refer to Colors. This setting applies only when the section's Blend mode option is not set to Normal.
Color > Color schemeUse the Color scheme options to select a color scheme for the section. Refer to Colors.
Color > Disable transitionSelect the checkbox Disable transition to turn on/off overriding the color transitions set in the section's theme settings. Setup defaults for this setting in Theme Settings > Colors > Transitions.
Spacing > Remove top paddingSelect the checkbox Remove top padding to add/remove the spacing (padding) that's displayed above the section. Refer to W3 Schools: CSS Padding.
Spacing > Remove bottom paddingSelect the checkbox Remove bottom padding to add/remove the spacing (padding) that's displayed below the section. Refer to W3 Schools: CSS Padding.
Theme settingsIf available, select Theme settings to access additional settings for the section. Refer to Section theme settings menu.
Custom CSSSelect Custom CSS. In the box, enter custom CSS styles to apply only to the current section. Refer to Shopify help: Add custom CSS. To apply custom styles to your entire online store, refer to Theme settings > Custom CSS.
Remove sectionSelect Remove section to delete the section from the current page.