Recently I noticed a new collection sort order as most-relevant which is not documented anywhere. Can someone from shopify team explain if there is an addition here Collection - GraphQL Admin or in collection webhooks?
Hey @Merchbees, good catch! most-relevant is a new collection sort option that recently went live for all merchants. It’s a valid sort order value, not a glitch.
It sorts products by relevancy, and new collections default to this sort order. Existing collections are unaffected, all previous sort options remain available, and merchants can switch at any time.
You’re right that the CollectionSortOrder enum reference and the collection webhook payload docs haven’t been updated to reflect this yet. If your app processes collection sort orders, I’d recommend handling most-relevant as a valid string value even though it’s not in the enum docs currently. These will be updated in the next little while - thanks for flagging!
@Donal-Shopify So is this how it works now? What about API versioning or changelog?
That’s a valid point. I’ve raised this directly with the collections team, including the missing changelog entry and documentation gap. I’ll update this thread once I hear back.
I heard back from the collections team and need to correct what I said earlier about this being live for all merchants. The most-relevant sort order is rolling out gradually and is currently active on a small percentage of stores, which is likely why you’re not seeing it in the admin.
On the versioning side, a changelog entry is planned to coincide with the rollout reaching 100%, and the CollectionSortOrder GraphQL enum update is tracking to be added to the 2026-07 release candidate. Your point about this needing a changelog entry was valid and has been raised with the team directly.
Thanks again for raising the inconsistencies you noticed with us.
You released a new feature without notifying developers, and there has been no changelog or versioning added.
Could you please handle this more properly—for example, by rolling it out through dev stores first so we can test unexpected features?
Also, for resources that use sort order (such as collections → products → sort key), this new value should be included. If the feature is already live, could you add this sort key to the existing API versions as well?
At the moment, I don’t see the new sort_key in version 2026-07, and the sort order doesn’t include this key either, despite your earlier mention. CollectionSortOrder - GraphQL Admin
@Donal-Shopify can you please explain is this relevance and this new most-relevant have any relationship?
Can you also make sure that new key is added here as well ProductCollectionSortKeys - GraphQL Admin
The feedback on the rollout process is fair and I’ve passed it along directly. The 2026-07 release candidate hasn’t been released yet, which is why the CollectionSortOrder enum doesn’t show the value. It will be added before 2026-07 is released.
The RELEVANCE sort key in ProductCollectionSortKeys and the new most-relevant collection sort order are separate things. RELEVANCE is a query-time sort key that applies when you pass a search query to a products connection. The most-relevant sort order is the collection-level default that determines how products are arranged when no explicit sort is requested.
The changelog entry about removing unnecessary RELEVANCE sort options was about cleaning up RELEVANCE from connections where it only worked with a search query, unrelated to this new sort order.
There isn’t a corresponding value in ProductCollectionSortKeys for the Storefront API at this time. Using COLLECTION_DEFAULT as the sort key will respect whatever the collection’s default sort order is.
@Donal-Shopify Can you explain how this new sort order behaves in practice in detail?
@Liam-Shopify Can you help us handle this situation so we can properly support the increasing number of customers using this new sort order by default?
Also @Donal-Shopify can you explain why ProductCollectionSortKeys won’t include it? It’s not a storefront API. Collection - GraphQL Admin
This is an important API where we get the product order in a collection based on the sort key like best-selling.
In addition to the GraphQL resources, there are two REST Admin APIs that support updating the sort order, where this new sort order also needs to be included.