Skip to content
Saleor
Esc
↑↓navigate↵open⌘Jpreview

Schema: Saleor 3.23.43Download SDLUpgrade guides

On this page

collection Query

Look up a collection by ID, slug or external reference. If slugLanguageCode is provided, category will be fetched by slug translation.

Requires one of the following permissions to include the unpublished items:MANAGE_ORDERSMANAGE_DISCOUNTSMANAGE_PRODUCTS
collection(id: ID, slug: String, slugLanguageCode: LanguageCodeEnum, externalReference: String, channel: String): Collection

Returns

Collection

Show return type
type Collection implements Node & ObjectWithMetadata {
  id: ID!
  privateMetadata: [MetadataItem!]!
  privateMetafield(key: String!): String
  privateMetafields(keys: [String!]): Metadata
  metadata: [MetadataItem!]!
  metafield(key: String!): String
  metafields(keys: [String!]): Metadata
  seoTitle: String
  seoDescription: String
  name: String!
  description: JSONString
  fullDescription: JSONString
  slug: String!
  externalReference: String
  channel: String
  descriptionJson: JSONString @deprecated(reason: "Use the `description` field instead.")
  products(filter: ProductFilterInput @deprecated(reason: "Use `where` filter instead."), where: ProductWhereInput, search: String, sortBy: ProductOrder, before: String, after: String, first: Int, last: Int): ProductCountableConnection
  backgroundImage(size: Int, sizeRounding: ThumbnailSizeRoundingEnum = NEAREST, format: ThumbnailFormatEnum = ORIGINAL): Image
  translation(languageCode: LanguageCodeEnum!): CollectionTranslation
  channelListings: [CollectionChannelListing!]
}

Arguments

id

id · ID

ID of the collection.

slug

slug · String

Slug of the collection

slugLanguageCode

slugLanguageCode · LanguageCodeEnum

Language code of the collection slug, omit to use primary slug.

Added in Saleor 3.21

externalReference

externalReference · String

External ID of the collection.

Added in Saleor 3.23

channel

channel · String

Slug of a channel for which the data should be returned.


Schema: Saleor 3.23.43. Download SDL.

Last updated on April 13, 2026

Was this page helpful?