---
title: CollectionCreatePayload - GraphQL Admin
description: Return type for `collectionCreate` mutation.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/CollectionCreatePayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/CollectionCreatePayload.md
api_name: admin
api_type: graphql
type: payload
---

# Collection​Create​Payload

payload

Return type for `collectionCreate` mutation.

## Fields

* collection

  [Collection](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection)

  The collection that has been created.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/UserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [collection​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionCreate)

  mutation

  Creates a [collection](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) to group [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) together in the [online store](https://shopify.dev/docs/apps/build/online-store) and other [sales channels](https://shopify.dev/docs/apps/build/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`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CollectionCreateInput)). Each source adds products through `conditions` (such as product tag, title, or metafield—see [`CollectionSourceInclusionConditionInput`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/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](https://shopify.dev/docs/apps/build/custom-data/metafields/use-metafield-capabilities).

  * collection

    [Collection​Create​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CollectionCreateInput)

    ### Arguments

    The properties and sources to use when creating the collection. Define product membership with `sources` (conditions and manual selections) instead of the legacy `ruleSet`.

  * input

    [Collection​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CollectionInput)

    Deprecated

  ***

***

## Map

### Mutations with this payload

* [collection​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionCreate)