Sections reference

Product rail

Displays a horizontally scrollable product rail from a selected collection.

Available on

index, cart (as the empty-bag recommendations rail)

Source file

sections/product-rail.liquid

Blocks

none

Merchant notes. Product rails are the only storefront areas that scroll horizontally on mobile. Renders server side first (so it still shows up with JS disabled and for SEO), then assets/product-rail.js swaps in a freshly fetched copy of just this section - if that fetch fails, this rail shows its own retry banner instead of affecting the rest of the page. The wrapper always renders (hidden via the `hidden` attribute, not removed from the DOM by Liquid) when `only_when_cart_empty` is set, so `data-section-id` stays discoverable by assets/cart.js's Section Rendering requests even while the cart isn't empty - otherwise this rail could never be told to reappear after an Ajax cart change without a full reload.

Settings

Setting	Type	Details
`heading` Heading	text	default: Currently on everyone's wishlist
`collection` Collection	collection
`products_to_show` Products to show	range	2–12 step 1 · default: 4
`link_label` Link label	text	default: See all
`link` Link	url
`only_when_cart_empty` Only show when the cart is empty	checkbox	default: false

Blocks

This section has no configurable blocks.

Depends on

snippets/product-card.liquid
assets/product-rail.js