Skip to main content

​
Overview

Blocks provide a flexible system for displaying product recommendations across your storefront. Unlike static product lists, blocks dynamically generate recommendations based on context, customer behavior, and configurable rules. Key capabilities:
  1. Multiple anchor types - Display recommendations on product pages, collection pages, in the cart, or globally
  2. Flexible strategies - Choose from interaction-based, similarity-based, or manual curation
  3. Conditional rules - Modify block behavior based on customer context and product attributes
  4. Safeguards - Ensure blocks always display appropriately with minimum/maximum constraints and control personalization strength
  5. Fallback chains - Automatically use alternative blocks when primary blocks don’t return enough products

​
Anchor types

Anchor types determine where a block appears on your storefront and what context it uses to generate recommendations.

​
Product anchor

Display recommendations on product pages. The block uses the current product as the anchor to find related products. Common use cases:
  • “Frequently Bought Together” on product pages
  • “Customers Also Viewed” recommendations
  • “Similar Products” suggestions
  • “Complete the Look” cross-sells

​
Collection anchor

Display recommendations on collection pages. The collection is determined dynamically from the anchor_id parameter in the API request, which can be either a collection ID or handle. How it works:
  • The collection is resolved at request time using the anchor_id parameter
  • No collection selection is required in the dashboard
  • Supports both collection IDs (numeric) and handles (string)
Common use cases:
  • “Browsed Then Bought” — products purchased by shoppers who browsed the collection
  • “Trending in Collection” — products trending within the collection
  • Similar products based on the collection’s catalog
  • Featured products within a collection
  • “Editor’s Picks” for specific collections
  • Collection-specific promotions

​
Cart anchor

Display recommendations in the cart. The block uses products currently in the cart to find complementary items. Common use cases:
  • “Complete the Look” in cart
  • “Frequently Bought Together” based on cart contents
  • Cross-sell recommendations before checkout

​
None anchor

Global blocks that can appear anywhere on your storefront. These blocks don’t require any anchor context. Common use cases:
  • “Best Sellers” on homepage
  • “New Arrivals” on homepage
  • “Featured Products” on static pages
  • “Trending Now” global widget

​
See also