Skip to main content

​
Block priority and ordering

When multiple blocks target the same anchor type, you can control which block is used through priority ordering.

​
Priority system

Blocks have a priority field that determines evaluation order:
  • Lower numbers = higher priority
  • Blocks are evaluated in ascending priority order
  • The first block whose rules match is used

​
Use cases for multiple blocks

Geographic targeting: 
Block 1 (priority 0): US visitors → US-specific recommendations
Block 2 (priority 1): EU visitors → EU-specific recommendations
Block 3 (priority 2): Default → Global recommendations
Customer segmentation: 
Block 1 (priority 0): VIP customers → Premium recommendations
Block 2 (priority 1): Returning customers → Personalized recommendations
Block 3 (priority 2): New visitors → Popular products
Device optimization: 
Block 1 (priority 0): Mobile → Mobile-optimized layout (8 products)
Block 2 (priority 1): Desktop → Desktop layout (16 products)

​
Block status

Blocks have a status field that controls whether they’re active:
  • Active: Block is live and will be returned by the API
  • Draft: Block is not live and won’t be returned by the API
Only active blocks are evaluated when processing API requests. Draft blocks are useful for:
  • Testing new block configurations before going live
  • Temporarily disabling blocks without deleting them
  • Preparing seasonal blocks in advance

​
See also