Choose a version:

collection

query

Retrieves a collection by its ID. A collection represents a grouping of products that merchants can display and sell as a group in their online store and other sales channels.

Use the collection query when you need to:

Manage collection publishing across sales channels
Access collection metadata and SEO information
Work with collection rules and product relationships

A collection can be either a custom (manual) collection where products are manually added, or a smart (automated) collection where products are automatically included based on defined rules. Each collection has associated metadata including title, description, handle, image, and metafields.

Arguments

Anchor to idid •ID! required: The ID of the Collection to return.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to CollectionCollection •Collection: The Collection object represents a group of products 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, sales channels, and marketing campaigns.

There are two types of collections:

Custom (manual) collections: You specify the products to include in a collection.

Smart (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 mutation after creation.
Collections can be displayed in a store with Shopify's theme system through Liquid templates and can be customized with template suffixes 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.

Was this section helpful?

Get a collection by ID
Get a metafield attached to a collection
Get metafields attached to a collection
Get pinned metafield definitions associated with a collection
Retrieve product_ids that are published to a collection_id
Retrieve a list of products belonging to a collection
Retrieve a specific collection listing that is published to your app
Retrieves a single collection
Retrieves a single custom collection
Retrieves a single smart collection
Returns null when collection is not found

Examples

Open in GraphiQL

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query {

collection(id: "gid://shopify/Collection/841564295") {

title

handle

updatedAt

}

}`,

);

const data = await response.json();

query {
  collection(id: "gid://shopify/Collection/841564295") {
    id
    title
    handle
    updatedAt
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { collection(id: \"gid://shopify/Collection/841564295\") { id title handle updatedAt } }"
}'

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  query {
    collection(id: "gid://shopify/Collection/841564295") {
      id
      title
      handle
      updatedAt
    }
  }`,
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    collection(id: "gid://shopify/Collection/841564295") {
      id
      title
      handle
      updatedAt
    }
  }`,
});

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query {
    collection(id: "gid://shopify/Collection/841564295") {
      id
      title
      handle
      updatedAt
    }
  }
QUERY

response = client.query(query: query)

Response

JSON

{

"collection": {

"id": "gid://shopify/Collection/841564295",

"title": "IPods",

"handle": "ipods",

"updatedAt": "2008-02-02T00:00:00Z"

}