`RenderedCollection`

Response of GET collection/:handle (rendered collection): the stored Shopify collection body spread at the top level, plus campaign/config, facets/products, sort_order and the echoed query.

Type: object

Field Type Description

id number

rules optional ShopifyCollectionRule[]

title string

handle string

body_html string

metafields optional

{ [key]: { [key]: any } }

Namespace -> key -> value (save-collection.service mapMetafieldsIntoCorrectFormat).

Fields

Field	Type	Description
`[key: string]`	{ [key]: any }	Any further keys.

updated_at optional string

disjunctive optional boolean

published_at optional string

collection_type optional string

published_scope optional string

template_suffix optional string | null

admin_graphql_api_id optional string

campaign optional

any

Campaign attached to the collection, if any.

config

object

Collection config plus the collection's implode flag.

Fields

Field	Type	Description
`implode`	boolean
`[key: string]`	any	Any further keys.

facets SearchFacets

products RenderedProduct[]

sort_order

MercurySortOrder

Resolved sort order actually applied.

query

FilterOperator[]

Echo of the parsed query filter operators ([] when unparsable).

grid_config optional

GridConfig

Present when grid_config was requested (any non-empty string).

[key: string]

any

Any further keys.

Example (illustrative)

{
  "id": 7712345678901,
  "rules": [
    {
      "column": "string",
      "relation": "string",
      "condition": "string"
    }
  ],
  "title": "Linen shirt",
  "handle": "linen-shirt",
  "body_html": "<p>Breathable linen.</p>",
  "metafields": {
    "custom": {
      "custom": null
    }
  },
  "updated_at": "2026-11-01T00:00:00.000Z",
  "disjunctive": false,
  "published_at": "2026-11-01T00:00:00.000Z",
  "collection_type": "Shirts",
  "published_scope": "string",
  "template_suffix": "string",
  "admin_graphql_api_id": "7712345678901",
  "campaign": null,
  "config": {
    "implode": false
  },
  "facets": {
    "vendors": [
      {
        "vendor": "Mercury Apparel",
        "count": 12
      }
    ],
    "types": [
      {
        "type": "Shirts",
        "count": 12
      }
    ],
    "tags": [
      {
        "value": "string",
        "count": 12
      }
    ],
    "count": 12
  },
  "products": [
    {
      "id": "7712345678901",
      "title": "Linen shirt",
      "implode": 1,
      "handle": "linen-shirt",
      "min_price": 89,
      "compare_at_min_price": 89,
      "vendor": "Mercury Apparel",
      "type": "Shirts",
      "on_sale": false,
      "total_stock": 12,
      "variants": [
        {
          "title": "Linen shirt",
          "id": 7712345678901,
          "inventory": 12,
          "price": "89.00",
          "compare_at_price": "89.00"
        }
      ],
      "prices": {
        "AUD": {
          "price": 89
        }
      },
      "created_date": "2026-11-01T00:00:00.000Z",
      "options": null,
      "normalised_stock": 12,
      "tags": [
        "summer"
      ],
      "image": "https://cdn.shopify.com/s/files/1/0000/0001/files/linen-shirt.jpg",
      "images": [
        "https://cdn.shopify.com/s/files/1/0000/0001/files/linen-shirt.jpg"
      ],
      "related": "string",
      "imploded": [
        {
          "id": "7712345678901",
          "title": "Linen shirt",
          "implode": 1,
          "handle": "linen-shirt",
          "min_price": 89,
          "max_price": 89,
          "compare_at_min_price": 89,
          "compare_at_max_price": 89,
          "vendor": "Mercury Apparel",
          "type": "Shirts",
          "on_sale": false,
          "total_stock": 12,
          "variants": [
            {
              "title": "Linen shirt",
              "id": 7712345678901,
              "inventory": 12,
              "price": "89.00",
              "compare_at_price": "89.00"
            }
          ],
          "prices": {
            "AUD": {
              "price": null
            }
          },
          "created_date": "2026-11-01T00:00:00.000Z",
          "tags": [
            "summer"
          ]
        }
      ],
      "meta": {
        "key": null
      }
    }
  ],
  "sort_order": "manual",
  "query": [
    {
      "type": "Shirts",
      "condition": "string",
      "value": null
    }
  ],
  "grid_config": {
    "grid": {
      "elements": {
        "key": null
      },
      "core": {
        "key": null
      },
      "breakpoints": [
        {
          "index": 1,
          "label": "string",
          "minwidth": 1,
          "columns": 1,
          "format": "string"
        }
      ],
      "currentBreakpoint": {
        "key": null
      },
      "styles": "string"
    },
    "currency": "AUD",
    "locale": "string",
    "delimiter": "string",
    "sizeMapping": null,
    "colourMapping": {
      "key": "#1f6feb"
    },
    "imageMapping": {
      "key": "string"
    },
    "facetMapping": null,
    "integrations": null,
    "skuSearch": null
  }
}

Used by

GET /search/collection/{handle}

Declared in api-types/src/storefront/models.ts.