Collection

Collection - curated group of products

type Collection implements Node {
  createdAt: DateTime!
  description(
    format: RichTextFormat = HTML
  ): String
  descriptionHtml: String @deprecated
  handle: String!
  id: ID!
  image: Image
  products(
    after: String
    before: String
    filters: [ProductFilter!]
    first: Int
    last: Int
    reverse: Boolean = false
    sortKey: ProductSortKeys = BEST_SELLING
  ): ProductConnection!
  seo: SEO
  title: String!
  updatedAt: DateTime!
}

Fields

Collection.createdAt ● DateTime! non-null scalar

Creation timestamp

Collection.description ● String scalar

Collection description. Returns ready-to-render HTML by default; pass format: TEXT for plain text or format: JSON for the structured document.

Collection.description.format ● RichTextFormat enum

Representation to return: HTML (ready-to-render markup, default), TEXT (plain text), or JSON (structured document).

Collection.handle ● String! non-null scalar

URL-friendly handle (slug)

Collection.id ● ID! non-null scalar

Unique identifier

Collection.image ● Image object

Collection image

Collection.products ● ProductConnection! non-null object

Products in collection

Collection.products.after ● String scalar

Cursor for forward pagination (cursor of the last edge from the previous page)

Collection.products.before ● String scalar

Cursor for backward pagination (cursor of the first edge from the next page)

Collection.products.filters ● [ProductFilter!] list input

Faceted filters to narrow the result set (collection scope always wins)

Collection.products.first ● Int scalar

Number of products to return from the start (forward pagination, max 100)

Collection.products.last ● Int scalar

Number of products to return from the end (backward pagination, max 100)

Collection.products.reverse ● Boolean scalar

Reverse the sort order when true (descending by sortKey)

Collection.products.sortKey ● ProductSortKeys enum

Sort key for ordering products within the collection

Collection.seo ● SEO object

SEO metadata

Collection.title ● String! non-null scalar

Collection title

Collection.updatedAt ● DateTime! non-null scalar

Last update timestamp

Show deprecatedHide deprecated

Collection.descriptionHtml ● String deprecated scalar

DEPRECATED

Use description(format: HTML). Scheduled for removal after 2026-09-02.

HTML collection description (DEPRECATED — use description(format: HTML)).

Interfaces

Node interface

GraphQL Node interface — universal ID-based lookup

Returned By

collection query

Member Of

CollectionEdge object

Implemented By

MenuItemResource union