FROM CACHE - en_header

what is the function of the 'published_scope' field?

Eric_Howard
Shopify Partner
10 0 0

Is there any more documentation about the "published_scope" field for custom collections? What is the field used for?

From: http://docs.shopify.com/api/customcollection

published_scope
{ "published_scope" : "global"}

The sales channels in which the custom collection is visible.

Thank you!

Replies 12 (12)
Kevin_Hughes
Shopify Staff (Retired)
Shopify Staff (Retired)
130 0 19

"global" means it will be visible everywhere and "web" means it won't show up on Point of Sale.

laura44
New Member
1 0 3

Hello,

What about the other way around -  if you want a product to appear on POS, but not on web?

 

Thanks

Laura

hassain
Shopify Staff (Retired)
Shopify Staff (Retired)
624 104 177

Hi @laura44 ,

 

If you are a merchant/store-owner you can set this through the Shopify Admin webpage by going opening the page for your specific product, and then on the right side of the screen clicking the "Manage" link next to Product Availability to select which channels you want your product to be published on.

 

However if you are building an app and want to accomplish this via the API and not use the web admin, this is only possible through GraphQL using the following resources:

In order to perform these mutations, your app will need the scope "write_publications". As of right now, we are only granting this scope to Private Apps. If you would like your Private App to have this scope, go to your Shopify Partners Dashboard and reach out to 'Partner Support' for more details.

Hassain | Developer Support Specialist @ Shopify
 - Was my reply helpful? Click Like to let me know! 
 - Was your question answered? Click Accept as Solution 

prerak1992
New Member
2 0 0

I have a product with published_scope" as "global", but the published_at date for this product is null. Any reason behind such a behavior?

Stkono
Tourist
6 0 3

Hi, 

I want to set the sales channel in the import product sheet. So I got 'global' and 'web' covered. But what about POS-only? As said, this is something I want to set in the sheet which I import (not for each of my 1500 products in the Admin console). 

Best regards,
Stefan

PeanutButter
Shopify Partner
376 67 170

I have the same issue, I need an option to set published_scope to "pos only"

Peanut Butter Collective | Shopify Experts
- Was my reply helpful? Please Like and Accept Solution.
- Want to customize and improve your store? Hire us.
- Feel free to contact me us hello@peanutbutter.es
gonerrecords
Tourist
3 0 9
dizzlerizzle
New Member
1 0 0
davidalarcon
Shopify Partner
7 0 2

Same here, with multichannel strategy this should be a must for Shopify

davidalarcon
Shopify Partner
7 0 2

I experienced the same. The thing is that there is an unexpected behavior that changes the published_at value when switching a product from active to draft, published_at changes from any date value you have sent previously to null.

suser
Shopify Partner
2 0 0

I'm having this same issue. Lots of strange behavior in my first experience with ShopifyAPI.

suser
Shopify Partner
2 0 0

Has anyone came up with a solution? I'm currently trying to upload 1000+ products to Shopify for a client and I really don't want to tell her she has to click through each one online and change the published scopes. It's been years and no solution?