Back to Changelog
Product Update

Dynamic Sorting for Listings

Give your customers flexible, context-aware sorting options with the new Dynamic Sorting system for listings.

What's New

  • Position-Based Sorting - Add a sorting field to your storage with identifier/position pairs. Each product stores its position for different sort contexts (categories, collections, campaigns).
  • Identifier-Driven Queries - Pass an identifier when calling the API, and results are sorted according to the positions defined for that identifier. Request sort=featured&identifier=electronics and products appear in Electronics' curated order.
  • External Sort Data - Map position data from merchandising systems, recommendation engines, or PIMs through Value Composer. Your external sorting decisions flow directly into your API.
  • High-Performance Queries - Sort data is indexed for fast queries, even on large catalogs.

Use Cases

  • Category Sorting - Define a different product order for each category. Electronics shows bestsellers first; Clothing leads with new arrivals.
  • Seasonal Campaigns - Create sort identifiers for promotions. Update positions for Black Friday without touching code.
  • Personalization - Feed ML-generated sort scores from recommendation engines.
  • B2B Ordering - Customer-specific product positions based on purchase history or contracts.

How It Works

  1. Add a sorting field to your storage with identifier/position structure
  2. Map position data from your source systems via Value Composer
  3. Configure the sorting field in your listing
  4. Pass the identifier in API requests to sort by that context

Documentation

Learn more about Listings and Storage field configuration.

Share this update