---
title: Collection - GraphQL Admin
description: >-
  The `Collection` object represents a group of
  [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product)

  that merchants can organize to make their stores easier to browse and help
  customers find related products.

  Collections serve as the primary way to categorize and display products across

  [online stores](https://shopify.dev/docs/apps/build/online-store),

  [sales channels](https://shopify.dev/docs/apps/build/sales-channels), and
  marketing campaigns.


  There are two types of collections:


  - **[Custom (manual)
  collections](https://help.shopify.com/manual/products/collections/manual-shopify-collection)**:
  You specify the products to include in a collection.

  - **[Smart (automated)
  collections](https://help.shopify.com/manual/products/collections/automated-collections)**:
  You define rules, and products matching those rules are automatically included
  in the collection.


  The `Collection` object provides information to:


  - Organize products by category, season, or promotion.

  - Automate product grouping using rules (for example, by tag, type, or price).

  - Configure product sorting and display order (for example, alphabetical,
  best-selling, price, or manual).

  - Manage collection visibility and publication across sales channels.

  - Add rich descriptions, images, and metadata to enhance discovery.


  > Note:

  > Collections are unpublished by default. To make them available to customers,

  use the
  [`publishablePublish`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publishablePublish)

  mutation after creation.


  Collections can be displayed in a store with Shopify's theme system through
  [Liquid
  templates](https://shopify.dev/docs/storefronts/themes/architecture/templates/collection)

  and can be customized with [template
  suffixes](https://shopify.dev/docs/storefronts/themes/architecture/templates/alternate-templates)

  for unique layouts. They also support advanced features like translated
  content, resource feedback,

  and contextual publication for location-based catalogs.


  Learn about [using metafields with smart
  collections](https://shopify.dev/docs/apps/build/custom-data/metafields/use-metafield-capabilities).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection.md'
---

# Collection

object

Requires `read_products` access scope.

The `Collection` object represents a group of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) that merchants can organize to make their stores easier to browse and help customers find related products. Collections serve as the primary way to categorize and display products across [online stores](https://shopify.dev/docs/apps/build/online-store), [sales channels](https://shopify.dev/docs/apps/build/sales-channels), and marketing campaigns.

There are two types of collections:

* **[Custom (manual) collections](https://help.shopify.com/manual/products/collections/manual-shopify-collection)**: You specify the products to include in a collection.
* **[Smart (automated) collections](https://help.shopify.com/manual/products/collections/automated-collections)**: You define rules, and products matching those rules are automatically included in the collection.

The `Collection` object provides information to:

* Organize products by category, season, or promotion.
* Automate product grouping using rules (for example, by tag, type, or price).
* Configure product sorting and display order (for example, alphabetical, best-selling, price, or manual).
* Manage collection visibility and publication across sales channels.
* Add rich descriptions, images, and metadata to enhance discovery.

***

Note

Collections are unpublished by default. To make them available to customers, use the [`publishablePublish`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publishablePublish) mutation after creation.

***

Collections can be displayed in a store with Shopify's theme system through [Liquid templates](https://shopify.dev/docs/storefronts/themes/architecture/templates/collection) and can be customized with [template suffixes](https://shopify.dev/docs/storefronts/themes/architecture/templates/alternate-templates) for unique layouts. They also support advanced features like translated content, resource feedback, and contextual publication for location-based catalogs.

Learn about [using metafields with smart collections](https://shopify.dev/docs/apps/build/custom-data/metafields/use-metafield-capabilities).

## Fields

* activeOperations
* availablePublicationsCount
* description
* descriptionHtml
* events
* feedback
* handle
* hasProduct
* id
* image
* legacyResourceId
* metafield
* metafields
* products
* productsCount
* publishedOnCurrentPublication
* publishedOnPublication
* resourcePublications
* resourcePublicationsCount
* resourcePublicationsV2
* ruleSet
* seo
* sortOrder
* templateSuffix
* title
* translations
* unpublishedPublications
* updatedAt

### Deprecated fields

* metafieldDefinitions: deprecated
* publicationCount: deprecated
* publications: deprecated
* publishedOnChannel: deprecated
* publishedOnCurrentChannel: deprecated
* storefrontId: deprecated
* unpublishedChannels: deprecated

***

## Map

### Fields and connections with this object

* [Channel.collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel#field-Channel.fields.collections)
* [CollectionConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/CollectionConnection#returns-nodes)
* [CollectionEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/CollectionEdge#field-CollectionEdge.fields.node)
* [CollectionPublication.collection](https://shopify.dev/docs/api/admin-graphql/latest/objects/CollectionPublication#field-CollectionPublication.fields.collection)
* [DiscountCollections.collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCollections#field-DiscountCollections.fields.collections)
* [PriceRuleItemEntitlements.collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleItemEntitlements#field-PriceRuleItemEntitlements.fields.collections)
* [PriceRuleLineItemPrerequisites.collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleLineItemPrerequisites#field-PriceRuleLineItemPrerequisites.fields.collections)
* [Product.collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product#field-Product.fields.collections)
* [Publication.collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.collections)

### Possible type in

* [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReference)
* [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer)

***

## Queries

* collection
* collectionByIdentifier
* collections
* collectionByHandle: deprecated

***

## Collection Queries

### Queried by

* [collection](https://shopify.dev/docs/api/admin-graphql/latest/queries/collection)
* [collection​By​Identifier](https://shopify.dev/docs/api/admin-graphql/latest/queries/collectionByIdentifier)
* [collections](https://shopify.dev/docs/api/admin-graphql/latest/queries/collections)

***

## Mutations

* collectionAddProducts
* collectionCreate
* collectionDuplicate
* collectionUpdate

### Deprecated mutations

* collectionPublish: deprecated
* collectionUnpublish: deprecated

***

## Collection Mutations

### Mutated by

* [collection​Add​Products](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionAddProducts)
* [collection​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionCreate)
* [collection​Duplicate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionDuplicate)
* [collection​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionUpdate)

***

## Interfaces

* HasEvents
* HasMetafieldDefinitions
* HasMetafields
* HasPublishedTranslations
* Node
* Publishable

***

## Collection Implements

### Implements

* [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents)
* [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions)
* [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields)
* [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)
* [Publishable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Publishable)