Collection object

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

Required access

unauthenticated_read_product_listings access scope.

Connections

  • metafields (MetafieldConnection!)

    A paginated list of metafields associated with the resource.

    Argument Description
    after ( String )

    Returns the elements that come after the specified cursor.

    before ( String )

    Returns the elements that come before the specified cursor.

    first ( Int )

    Returns up to the first n elements from the list.

    last ( Int )

    Returns up to the last n elements from the list.

    namespace ( String )

    Container for a set of metafields (maximum of 20 characters).

    reverse ( Boolean )

    Reverse the order of the underlying list.
    Default value: false

  • products (ProductConnection!)

    List of products in the collection.

    Argument Description
    after ( String )

    Returns the elements that come after the specified cursor.

    before ( String )

    Returns the elements that come before the specified cursor.

    filters ( [ProductFilter!] )

    Returns a subset of products matching all product filters.

    first ( Int )

    Returns up to the first n elements from the list.

    last ( Int )

    Returns up to the last n elements from the list.

    reverse ( Boolean )

    Reverse the order of the underlying list.
    Default value: false

    sortKey ( ProductCollectionSortKeys )

    Sort the underlying list by the given key.
    Default value: COLLECTION_DEFAULT

Fields

  • description (String!)

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

    Argument Description
    truncateAt ( Int )

    Truncates string after the given length.

  • descriptionHtml (HTML!)

    The description of the collection, complete with HTML formatting.

  • handle (String!)

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

  • id (ID!)

    Globally unique identifier.

  • image (Image)

    Image associated with the collection.

    Argument Description
    crop ( CropRegion )

    Crops the image according to the specified region. This argument is deprecated: Use crop on Image.transformedSrc instead.

    maxHeight ( Int )

    Image height in pixels between 1 and 2048. This argument is deprecated: Use maxHeight on Image.transformedSrc instead.

    maxWidth ( Int )

    Image width in pixels between 1 and 2048. This argument is deprecated: Use maxWidth on Image.transformedSrc instead.

    scale ( Int )

    Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use scale on Image.transformedSrc instead.
    Default value: 1

  • metafield (Metafield)

    Returns a metafield found by namespace and key.

    Argument Description
    key ( String! ) required

    Identifier for the metafield (maximum of 30 characters).

    namespace ( String! ) required

    Container for a set of metafields (maximum of 20 characters).

  • title (String!)

    The collection’s name. Limit of 255 characters.

  • updatedAt (DateTime!)

    The date and time when the collection was last modified.

Types that return Collection