Improved
Reviews storefront: three more sort options
November 12th, 2026
The V3 storefront review endpoints accept 8 sort values. We listed 5. The full list: smart, smart_optimistic, date, rating, images, votes_up, votes_down and badge.
Also clarified:
sortingson the search endpoints takes the same 8 values. It's applied first, and thesortquery parameter then breaks ties. An unsupportedsortByvalue returns500, so send only the listed values.perPageis capped at 150 with no error.pagination.perPagein the response shows the value used.
Updated guides: Building custom reviews widgets and Headless integration.
