Upcoming changes to SmartCollection API

Dominique_Simo1
Shopify Staff
40 0 11

Shopify currently requires that products within smart collections be sorted either manually or automatically. Manual sorting means that all products are sorted manually into the required display order. Automatic sorting enables products to be sorted automatically (for example, alphabetically or chronologically).

Beginning in mid October, it will be possible to sort some products manually within smart collections. This lets you set a smart collection to any automatic sort order, and then specify a subset of products to be sorted manually. Any products that aren't manually sorted will be automatically sorted according to a specified automatic sort order.

This change means that the manual setting of the sort_order property will be deprecated, and that the order endpoint, like Shopify's admin, will be limited to manually sorting 250 products.

 

Deprecation Schedule

From mid October to early December 2018, the feature will be released progressively across Shopify stores. At that time, you'll also be able to enable the feature on development stores for testing purposes.

 

For more information on the changes, please see the migration guide. There are some planned additions we'll be making to the guide, and if you have any questions which aren't answered, please let us know.

Replies 16 (16)
TomDavies
Shopify Partner
15 1 11

Perfect - that's good to hear the sort order will work as expected.  Thanks Dominique.

⭐️ Flair product badges https://apps.shopify.com/flair ⭐️ Best Sellers - https://apps.shopify.com/best-sellers
Searchanise_Tea
Tourist
8 0 2

Hi Dominique

>> How about custom collections? Are you going to add the same endpoint for them?

>> There isn't currently a plan to add a /custom_collection/{id}/products endpoint. Can you tell me what you'd like to use it for, and what problem you're trying to solve that our existing APIs don't work well for? We do have /products.json?collection_id=12346.

Adding the /custom_collection/{id}/products endpoint allows to use the same code to get the data about product order in smart and custom collections. It will simplify the code and will allow not to use the Collects API anymore.

 

TomDavies
Shopify Partner
15 1 11

Hi Dominique,

The endpoint will be available mid-October, at which point you can start testing on your partner shop if you have the Manual Sort feature enabled, which can be requested by contacting deprecations@shopify.com. We won't enable this feature on merchant shops until a bit later.

I'd like some clarity this — when will the new manual sort feature be rolled out to merchant shops?

Due to the progressive rollout, apps will need to support both APIs during the transition.  How can an app determine if the new manual sort is enable for a shop?

I've been debating adding a field to smart collections so that API clients can know, without querying products, whether a collection uses the feature, and also whether it has manually sorted products

This approach would be ok to determine if this manual sort feature is enabled.  Howver, this feels like something that belongs on the Shop resource since it is shop-wide setting.  Maybe you could add a (progressive rollout) features list to the Shop JSON?  

Thanks,

Tom

⭐️ Flair product badges https://apps.shopify.com/flair ⭐️ Best Sellers - https://apps.shopify.com/best-sellers
Per_Arne
Excursionist
16 0 7

Is there any new information of when this will be roled out? We are waiting to launch our new Shopify store until this is released... ? 

Thomas_J_
New Member
3 0 1

Well this change isn't exactly welcome for us as we like to have a "all products" collection that is fully manually ordered, but we'll have to do with it.

One question though: when this change will be effective, will we need to re-order our first 250 products, or will this order be kept intact?

Thanks.

Per_Arne
Excursionist
16 0 7

Any news about this function? Is it launched?

Dominique_Simo1
Shopify Staff
40 0 11

We decided to wait until after BFCM and the holidays to enable this new feature. In 2019, the feature will be released progressively across Shopify stores. At that time, you'll also be able to enable the feature on development stores for testing purposes. You will be given approximately one month's notice to update your apps before this feature is enabled on any shops that will be impacted by these changes.


 

One question though: when this change will be effective, will we need to re-order our first 250 products, or will this order be kept intact?

The order will be kept intact.


In the meantime, if you have feature requests for collections and related APIs, I'd love to hear them in this thread.


Dominique