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

CollectionInput input object

Version unstable

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2021-01 (Release candidate)

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2020-10 (Latest)

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2020-07

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2020-04

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2020-01

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2019-10 (Unsupported)

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2019-07 (Unsupported)

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.

Version 2019-04 (Unsupported)

Specifies the input fields required to create a collection.

Input fields

descriptionHtml (String)

The description of the collection, in HTML format.

handle (String)

A unique human-friendly string for the collection. Automatically generated from the collection's title.

id (ID)

Specifies the collection to update or create a new collection if absent.

image (ImageInput)

The image associated with the collection.

metafields ([MetafieldInput!])

The metafields to associate with this collection.

privateMetafields ([PrivateMetafieldInput!])

The private metafields to associated with this product.

products ([ID!])

Initial list of collection products. Only valid with productCreate and without rules.

publications ([CollectionPublicationInput!])

Initial list of collection publications. Only valid with productCreate. This argument is deprecated: Use PublishablePublish instead.

redirectNewHandle (Boolean)

Indicates whether a redirect is required after a new handle has been provided. If true, then the old handle is redirected to the new one automatically.

ruleSet (CollectionRuleSetInput)

The rules used to assign products to the collection.

seo (SEOInput)

SEO information for the collection.

sortOrder (CollectionSortOrder)

The order in which the collection's products are sorted.

templateSuffix (String)

The theme template used when viewing the collection in a store.

title (String)

Required for creating a new collection.