Section reference

Product and merchandising sections

Choose product sections by shopping intent: direct purchase, curated edit, collection path, lifestyle context, product proof, or motion-led launch moment.

Product cardsQuick addFeatured productsMerchandising grids

Product merchandising sections should reduce the distance between interest and purchase. The important settings are not only layout controls; they decide whether customers can compare products, select variants, add to cart, or understand why a product is featured.

Product card anatomy diagram
Product merchandising depends on card media, quick add, swatches, price, badges, and gallery behavior working together.
  • Card settings affect collection grids, featured product grids, recommendations, and search results.
  • Quick add should match the product's variant complexity.
  • Swatches need consistent product option names and variant data.

Key Settings To Decide First

Theme editor setting

product source / collection source

What this controls

The product set a section uses, either from a Shopify collection or manual picks.

When to change it

A section pulls products automatically.

Watch out

Using manual products everywhere and then expecting collection sorting to apply.

Theme editor setting

products_to_show / product count

What this controls

How many product cards appear before the section ends or paginates.

When to change it

The section feels too long or too sparse.

Watch out

Showing too many products before customers understand the page's main path.

Theme editor setting

quick add behavior

What this controls

The action customers use to add products from cards without opening the product page.

When to change it

Customers can add products from cards.

Watch out

Direct add when customers must choose size, color, material, or subscription.

Theme editor setting

card gallery / hover image

What this controls

Extra product imagery shown from a product card through hover, arrows, dots, or gallery controls.

When to change it

Customers need to inspect more than one product image from a card.

Watch out

Using card galleries when product media is inconsistent or low quality.

Theme editor setting

swatches

What this controls

Small color, material, or option indicators shown on product cards.

When to change it

Products have color, material, or finish variants.

Watch out

Expecting swatches to work when option names vary across products.

Theme editor setting

custom image / image mask

What this controls

Art-directed image overrides and crop shapes used in featured product cards.

When to change it

Featured product grid needs art direction beyond product media.

Watch out

Using decorative masks that hide product detail.

Theme editor setting

carousel / slideshow controls

What this controls

Navigation controls that let customers move through product cards or slides.

When to change it

The section contains more products than fit comfortably.

Watch out

Hiding controls or auto-rotating products too quickly.

Theme editor setting

animation timing / trigger mode

What this controls

The pace and start condition for motion-led merchandising sections.

When to change it

Using Card reveal or other motion-led merchandising.

Watch out

Making the shopping path depend on a long animation.

Recommended Merchant Setups

SettingLocationRecommendedNotes
Homepage shopping editFeatured product grid3 to 6 products, below-card swatches, quick add modal for variantsUse this before long editorial sections so customers see products early.
Single product launch blockFeatured product or Product promoOne product, clear offer, primary CTA, concise supporting copyUse Featured product when customers can buy in-section; use Product promo when click-through is better.
Lifestyle sellingShop the lookOne clear image with obvious products and hotspotsHotspots should identify products customers can actually buy.
Proof-based merchandisingBest sellers or Best sellers slideshowReal best-seller collection, readable names/prices, clear controlsDo not label products as best sellers unless the set is credible.
Motion-led product momentCard revealOne page moment, short section, nearby static product pathUse for brand impact, not as the only way to browse products.

Common mistakes

  • Using direct quick add for products with required variant choices.
  • Showing too many products in a curated section, making it feel like a catalog.
  • Using custom art-directed images that no longer match the actual product page media.
  • Adding card reveal or carousel behavior without obvious controls.
  • Hiding core buying information such as price, stock, size, or variant choices behind decorative layouts.