---
title: Collection - Storefront API
description: |
  A collection represents a grouping of products that a shop owner can create to
  organize them or make their shops easier to browse.
api_version: 2025-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/collection
  md: https://shopify.dev/docs/api/storefront/latest/objects/collection.md
---

# Collection

object

Requires `unauthenticated_read_product_listings` access scope.

A collection represents a grouping of products that a shop owner can create to organize them or make their shops easier to browse.

## Fields

* description

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  Stripped description of the collection, single line with HTML tags removed.

  * truncate​At

    [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

    ### Arguments

    Truncates a string after the given length.

  ***

* description​Html

  [HTML!](https://shopify.dev/docs/api/storefront/latest/scalars/HTML)

  non-null

  The description of the collection, complete with HTML formatting.

* handle

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  A human-friendly unique string for the collection automatically generated from its title. Limit of 255 characters.

* id

  [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID)

  non-null

  A globally-unique ID.

* image

  [Image](https://shopify.dev/docs/api/storefront/latest/objects/Image)

  Image associated with the collection.

* metafield

  [Metafield](https://shopify.dev/docs/api/storefront/latest/objects/Metafield)

  A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

* metafields

  [\[Metafield\]!](https://shopify.dev/docs/api/storefront/latest/objects/Metafield)

  non-null

  A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.

* online​Store​Url

  [URL](https://shopify.dev/docs/api/storefront/latest/scalars/URL)

  The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel.

* products

  [Product​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/ProductConnection)

  non-null

  List of products in the collection.

* seo

  [SEO!](https://shopify.dev/docs/api/storefront/latest/objects/SEO)

  non-null

  The collection's SEO information.

* title

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  The collection’s name. Limit of 255 characters.

* tracking​Parameters

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  URL parameters to be added to a page URL to track the origin of on-site search traffic for [analytics reporting](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/report-types/default-reports/behaviour-reports). Returns a result when accessed through the [search](https://shopify.dev/docs/api/storefront/current/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/current/queries/predictiveSearch) queries, otherwise returns null.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime)

  non-null

  The date and time when the collection was last modified.

***

## Map

### Fields and connections with this object

* <->[CollectionConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/CollectionConnection#field-nodes)
* {}[CollectionEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/CollectionEdge#field-node)
* {}[PredictiveSearchResult.collections](https://shopify.dev/docs/api/storefront/latest/objects/PredictiveSearchResult#field-collections)
* {}[Product.collections](https://shopify.dev/docs/api/storefront/latest/objects/Product#field-collections)

### Possible type in

* [Menu​Item​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MenuItemResource)
* [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldParentResource)
* [Metafield​Reference](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldReference)

***

## Queries

* [collection](https://shopify.dev/docs/api/storefront/latest/queries/collection)

  query

  Fetch a specific `Collection` by one of its unique attributes.

* [collections](https://shopify.dev/docs/api/storefront/latest/queries/collections)

  query

  List of the shop’s collections.

* [collection​By​Handle](https://shopify.dev/docs/api/storefront/latest/queries/collectionByHandle)

  query

  Deprecated

***

## \<?>Collection Queries

### Queried by

* \<?>[collection](https://shopify.dev/docs/api/storefront/latest/queries/Collection)
* \<?>[collections](https://shopify.dev/docs/api/storefront/latest/queries/CollectionConnection)

***

## Interfaces

* * [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)

    interface

  * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)

    interface

  * [Online​Store​Publishable](https://shopify.dev/docs/api/storefront/latest/interfaces/OnlineStorePublishable)

    interface

  * [Trackable](https://shopify.dev/docs/api/storefront/latest/interfaces/Trackable)

    interface

***

## ||-Collection Implements

### Implements

* ||-[Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)
* ||-[Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)
* ||-[Online​Store​Publishable](https://shopify.dev/docs/api/storefront/latest/interfaces/OnlineStorePublishable)
* ||-[Trackable](https://shopify.dev/docs/api/storefront/latest/interfaces/Trackable)