CustomCollection

Version 2019-10

A custom collection is a grouping of products that a merchant can create to make their store easier to browse. The merchant creates a custom collection and then selects the products that will go into it.

Collections are typically displayed to customers so that buyers can select to view only the products in the collection. Shopify stores start with a single custom collection called frontpage—the collection of products shown on the front page of the online store.

The Collect resource is used to connect a product to a custom collection.

There are also smart collections, which contain products based on selection conditions rather than because they've been included manually. For more information, see the SmartCollection resource.

What you can do with CustomCollection

The Shopify API lets you do the following with the CustomCollection resource. More detailed versions of these general actions may be available:

CustomCollection properties

body_html
"body_html": "<p>The best selling iPods ever</p>"

The description of the custom collection, complete with HTML markup. Many templates display this on their custom collection pages.

handle
"handle": "ipods"

A human-friendly unique string for the custom collection automatically generated from its title. This is used in shop themes by the Liquid templating language to refer to the custom collection. (limit: 255 characters)

image
"image": {
  "src": "http://static.shopify.com/collections/ipod.jpg?0",
  "alt": "iPods",
  "width": 500,
  "height": 488,
  "created_at": "2018-04-19T09:34:47-04:00"
}

Image associated with the custom collection. Valid values are:

  • attachment: An image attached to a custom collection returned as Base64-encoded binary data.
  • src: The source URL that specifies the location of the image.
  • alt: Alternative text that describes the collecti