CollectionCreatePayload

The collection that has been created.

The list of errors that occurred from executing the mutation.

Creates a collection to group products together in the online store and other sales channels. For example, an athletics store might create different collections for running attire, shoes, and accessories.

Use the collectionCreate mutation when you need to:

• Create a new collection for a product launch or campaign
• Organize products by category, season, or promotion
• Automate product grouping using conditions (for example, by tag, type, or price)

Collections can include products manually and can also include products automatically based on rules, sources, or conditions.

Defining a collection's membership

Define membership with sources on the collection argument (CollectionCreateInput). Each source adds products through conditions (such as product tag, title, or metafield—see CollectionSourceInclusionConditionInput for the full list) and through manual selections.

Note: The <code>input</code> argument and its <code><span class="PreventFireFoxApplyingGapToWBR">rule<wbr/>Set</span></code> field are deprecated. Existing integrations should migrate to <code>collection</code> and <code>sources</code> — a <code><span class="PreventFireFoxApplyingGapToWBR">rule<wbr/>Set</span></code> rule maps to an equivalent source <code>condition</code> (for example, a tag rule becomes a <code><span class="PreventFireFoxApplyingGapToWBR">product<wbr/>Tag</span></code> condition). If both <code>collection</code> and <code>input</code> are provided, <code>collection</code> is used.

Note: The created collection is unpublished by default. To make it available to customers, use the <a href="https://shopify.dev/docs/api/admin-graphql/latest/mutations/publishablePublish"><code><span class="PreventFireFoxApplyingGapToWBR">publishable<wbr/>Publish</span></code></a> mutation after creation.

Learn more about using metafields with collection conditions.