API version: unstable
API version: 2021-04 Release candidate
API version: 2021-01 Latest
API version: 2020-10
API version: 2020-07
API version: 2020-04
API version: 2020-01 Unsupported
API version: 2019-10 Unsupported

publishableUnpublish mutation

Version unstable

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2021-04 (Release candidate)

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2021-01 (Latest)

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-10

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-07

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-04

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2020-01 (Unsupported)

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2019-10 (Unsupported)

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2019-07 (Unsupported)

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.

Version 2019-04 (Unsupported)

Unpublishes a resource from a channel. If the resource is a product, then its status must be active.

Required access

write_publications access scope. This scope is currently available only to private apps installed on Shopify Plus stores.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The resource to delete or update publications for.
input ( [PublicationInput!]! ) required

Specifies the input fields required to unpublish a resource.

PublicationInput fields

  • channelId (ID)

    ID of the channel. This argument is deprecated: Use publicationId instead.

  • publicationId (ID)

    ID of the publication.

  • publishDate (DateTime)

    The date and time that the resource was published. Setting this to a date in the future will schedule the resource to be published. Only online store channels support future publishing.

Return fields

  • publishable (Publishable)

    Resource that has been unpublished.

  • shop (Shop!)

    The user's shop.

  • userErrors ([UserError!]!)

    List of errors that occurred executing the mutation.