Scheduled publishing

Merchants can schedule products to be published to a sales channel at a specific datetime. Common use cases include product drops and timed sales, where merchants want to reserve sufficient inventory to meet spikes in customer demand.

Anchor to Validation workflowValidation workflow

If your channel app requires products to meet requirements before they can display to customers, then you need to validate products before their scheduled publication datetime. This gives merchants time to update products and resubmit them for validation. Otherwise, the channel validates the products at the scheduled datetime, and any updates required might delay their publication.

The following is the recommended workflow for channels that include validation:

1. A merchant schedules a product to be published on the channel app at a specified datetime.
2. Shopify sends a scheduled_product_listings/add event to the channel app.
3. The channel app validates the product against requirements for displaying it on the channel.
4. If the product fails validation, then the channel app sends feedback to the merchant using the ResourceFeedback object.
5. The merchant updates the product to meet the requirements.
6. Shopify sends a scheduled_product_listings/update event to the channel app.
7. The channel app validates the product against the requirements.
8. At the scheduled datetime, Shopify sends a product_listing/add event.
9. The channel app reads the product data and displays the product.

Anchor to RequirementsRequirements

• You've completed the getting started tutorials.
• Your app requires the read_product_listings access scope.

Anchor to Step 1: Identify products that are scheduled for publicationStep 1: Identify products that are scheduled for publication

Request resourcePublicationOnCurrentPublication on the GraphQL Admin API's Product object. A publishDate in the future indicates that the product is scheduled to display on the channel at the specified datetime.

{
  products(first: 10) {
    edges {
      node {
        title
        resourcePublicationOnCurrentPublication {
          publication {
            name
            id
          }
          publishDate
          isPublished
        }
      }
    }
  }
}

{
   "data":{
      "products":{
         "edges":[
            {
               "node":{
                  "title":"Baseball",
                  "resourcePublicationOnCurrentPublication":{
                     "publication":{
                        "name":"Sales Channel",
                        "id":"gid://shopify/Publication/2"
                     },
                     "publishDate":"2021-09-23T17:30:00Z",
                     "isPublished":false
                  }
               }
            },
            {
               "node":{
                  "title":"Soccer ball",
                  "resourcePublicationOnCurrentPublication":{
                     "publication":{
                        "name":"Sales Channel",
                        "id":"gid://shopify/Publication/2"
                     },
                     "publishDate":"2021-09-10T17:30:00Z",
                     "isPublished":true
                  }
               }
            }
         ]
      }
   }
}

Anchor to Step 2: Subscribe to webhooksStep 2: Subscribe to webhooks

Shopify's SCHEDULED_PRODUCT_LISTINGS webhooks notify channels when products are scheduled to be published.

The following is an example payload: