SmartCollection

A smart collection is a grouping of products defined by rules that are set by the merchant. Shopify automatically changes the contents of a smart collection based on the rules. Smart collections, like other types of collections, are used to break down the catalog of products into categories and make the shop easier to browse.

The Collect resource is used to connect a product to a smart collection. However, these collects can't be added or removed from the API as they're managed by the rules of the smart collection.

You can use the CustomCollection resource to work with collections where each product in the collection is manually chosen by the merchant.

Important

In 2019, a new way to sort products manually will be introduced progressively to shops. This feature will let merchants override automatic sort order by manually sorting up to 250 of the products in a smart collection. The sort_order property will no longer include manual as a valid sort order. When using the order endpoint to order products, they will become manually sorted. To learn more about this new feature, see the Smart collection migration guide .

What you can do with SmartCollection

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

SmartCollection properties

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

The description of the smart collection. Includes HTML markup. Many shop themes display this on the smart collection page.

handle
"handle": "smart-ipods"

A human-friendly unique string for the smart collection. Automatically generated from the title. Used in shop themes by the Liquid templating language to refer to the smart collection. (maximum: 255 characters)

id
"id": 482865238

The ID of the smart collection.

image
"image": {
  "src": "http://static.shopify.com/collections/ipod.jpg?0",
  "alt": "iPods"
}

The image associated with the smart collection. Valid values:

  • attachment: An image attached to a smart collection returned as Base64-encoded binary data.
  • src: A URL that specifies the location of the image.
  • alt: Alternative text that describes the collection image.
published_at
"published_at": "2008-02-01T19:00:00-05:00"

The date and time (ISO 8601 format) that the smart collection was published. Returns null when the collection is hidden.

published_scope
"published_scope": "global"

Whether the smart collection is published to the Point of Sale channel. Valid values:

  • web: The smart collection is published to the Online Store channel but not published to the Point of Sale channel.
  • global: The smart collection is published to both the Online Store channel and the Point of Sale channel.
rules
required
"rules": {
  "column": "variant_price",
  "relation": "less_than",
  "condition": "20"
}

The list of rules that define what products go into the smart collection. Each rule has the following properties:

  • column: The property of a product being used to populate the smart collection.

    Valid values for text relations:

    • title: The product title.
    • type: The product type.
    • vendor: The name of the product vendor.
    • variant_title: The title of a product variant.

    Valid values for number relations:

    • variant_compare_at_price: The compare price.
    • variant_weight: The weight of the product.
    • variant_inventory: The inventory stock. Note: not_equals does not work with this property.
    • variant_price: product price.

    Valid values for an equals relation:

    • tag: A tag associated with the product.
  • relation: The relationship between the column choice, and the condition.

    Valid values for number relations:

    • greater_than The column value is greater than the condition.
    • less_than The column value is less than the condition.
    • equals The column value is equal to the condition.
    • not_equals The column value is not equal to the condition.

    Valid values for text relations:

    • equals: Checks if the column value is equal to the condition value.
    • not_equals: Checks if the column value is not equal to the condition value.
    • starts_with: Checks if the column value starts with the condition value.
    • ends_with: Checks if the column value ends with the condition value.
    • contains: Checks if the column value contains the condition value.
    • not_contains: Checks if the column value does not contain the condition value.
  • condition: Select products for a smart collection using a condition. Values are either strings or numbers, depending on the relation value.

disjunctive
"disjunctive": false

Whether the product must match all the rules to be included in the smart collection. Valid values:

  • true: Products only need to match one or more of the rules to be included in the smart collection.
  • false: Products must match all of the rules to be included in the smart collection.
sort_order
"sort_order": "alpha-asc"

The order of the products in the smart collection. Valid values:

  • alpha-asc: The products are sorted alphabetically from A to Z.
  • alpha-des: The products are sorted alphabetically from Z to A.
  • best-selling: The products are sorted by number of sales.
  • created: The products are sorted by the date they were created, from oldest to newest.
  • created-desc: The products are sorted by the date they were created, from newest to oldest.
  • manual: The products are manually sorted by the shop owner. Deprecation will begin in 2019.
  • price-asc: The products are sorted by price from lowest to highest.
  • price-desc: The products are sorted by price from highest to lowest.

As of 2019, this property will represent automated sort orders only. A subset of products can be sorted manually on all automated collections using the order endpoint.

template_suffix
"template_suffix": null

The suffix of the Liquid template that the shop uses. By default, the original template is called product.liquid, and additional templates are called product.suffix.liquid.

title
required
"title": "Smart iPods"

The name of the smart collection. Maximum length: 255 characters.

updated_at
read-only
"updated_at": "2008-02-01T19:00:00-05:00"

The date and time (ISO 8601 format) when the smart collection was last modified.

products_manually_sorted_count
read-only
"products_manually_sorted_count": 106

The number of manually-sorted products in the smart collection.

Endpoints

GET /admin/smart_collections.json
Retrieves a list of smart collections
limit

The number of results to show.

(default: 50, maximum: 250)
page

The page of results to show.

(default: 1)
ids

Show only the results specified in this comma-separated list of IDs.

since_id

Restrict results to after the specified ID.

title

Show smart collections with the specified title.

product_id

Show smart collections that includes the specified product.

handle

Filter results by smart collection handle.

updated_at_min

Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)

updated_at_max

Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)

published_at_min

Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)

published_at_max

Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)

published_status

Filter results based on the published status of smart collections.

(default: any)
  • published: Show only published smart collections.
  • unpublished: Show only unpublished smart collections.
  • any: Show all smart collections.
fields

Show only certain fields, specified by a comma-separated list of field names.

Retrieve a list of all smart collections

GET /admin/smart_collections.json
View Response
HTTP/1.1 200 OK
{
  "smart_collections": [
    {
      "id": 482865238,
      "handle": "smart-ipods",
      "title": "Smart iPods",
      "updated_at": "2008-02-01T19:00:00-05:00",
      "body_html": "<p>The best selling ipod ever</p>",
      "published_at": "2008-02-01T19:00:00-05:00",
      "sort_order": "manual",
      "template_suffix": null,
      "disjunctive": false,
      "rules": [
        {
          "column": "type",
          "relation": "equals",
          "condition": "Cult Products"
        }
      ],
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Collection/482865238",
      "image": {
        "created_at": "2018-11-13T11:45:04-05:00",
        "alt": "iPod Nano 8gb",
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/ipod_nano_8gb.jpg?v=1542127504"
      }
    }
  ]
}

Retrieve a list all smart collections after a specified ID

GET /admin/smart_collections.json?since_id=482865238
View Response
HTTP/1.1 200 OK
{
  "smart_collections": [
    {
      "id": 1063001311,
      "handle": "ipods-1",
      "title": "IPods",
      "updated_at": "2018-11-13T11:45:26-05:00",
      "body_html": null,
      "published_at": "2018-11-13T11:45:26-05:00",
      "sort_order": "best-selling",
      "template_suffix": null,
      "disjunctive": false,
      "rules": [
        {
          "column": "title",
          "relation": "starts_with",
          "condition": "iPod"
        }
      ],
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Collection/1063001311"
    }
  ]
}

Retrieve a list of all smart collections for a certain product_id

GET /admin/smart_collections.json?product_id=632910392
View Response
HTTP/1.1 200 OK
{
  "smart_collections": []
}

Retrieve a list of specific smart collections

GET /admin/smart_collections.json?ids=482865238,1063001312
View Response
HTTP/1.1 200 OK
{
  "smart_collections": [
    {
      "id": 1063001312,
      "handle": "macbooks",
      "title": "Macbooks",
      "updated_at": "2018-11-13T11:45:29-05:00",
      "body_html": null,
      "published_at": "2018-11-13T11:45:29-05:00",
      "sort_order": "best-selling",
      "template_suffix": null,
      "disjunctive": false,
      "rules": [
        {
          "column": "vendor",
          "relation": "equals",
          "condition": "Apple"
        }
      ],
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Collection/1063001312"
    },
    {
      "id": 482865238,
      "handle": "smart-ipods",
      "title": "Smart iPods",
      "updated_at": "2008-02-01T19:00:00-05:00",
      "body_html": "<p>The best selling ipod ever</p>",
      "published_at": "2008-02-01T19:00:00-05:00",
      "sort_order": "manual",
      "template_suffix": null,
      "disjunctive": false,
      "rules": [
        {
          "column": "type",
          "relation": "equals",
          "condition": "Cult Products"
        }
      ],
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Collection/482865238",
      "image": {
        "created_at": "2018-11-13T11:45:04-05:00",
        "alt": "iPod Nano 8gb",
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/ipod_nano_8gb.jpg?v=1542127504"
      }
    }
  ]
}
GET /admin/smart_collections/count.json
Retrieves a count of smart collections
title

Show smart collections with the specified title.

product_id

Show smart collections that include the specified product.

updated_at_min

Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)

updated_at_max

Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)

published_at_min

Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)

published_at_max

Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)

published_status

Filter results based on the published status of smart collections.

(default: any)
  • published: Show only published smart collections.
  • unpublished: Show only unpublished smart collections.
  • any: Show all smart collections.

Retrieve a count of all smart collections

GET /admin/smart_collections/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}

Retrieve a count of all smart collections for a certain product_id

GET /admin/smart_collections/count.json?product_id=632910392
View Response
HTTP/1.1 200 OK
{
  "count": 0
}
GET /admin/smart_collections/482865238.json
Retrieves a single smart collection
fields

Show only certain fields, specified by a comma-separated list of field names.

Retrieve a specific collection by ID

GET /admin/smart_collections/#{smart_collection_id}.json
View Response
HTTP/1.1 200 OK
{
  "smart_collection": {
    "id": 482865238,
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2008-02-01T19:00:00-05:00",
    "body_html": "<p>The best selling ipod ever</p>",
    "published_at": "2008-02-01T19:00:00-05:00",
    "sort_order": "manual",
    "template_suffix": null,
    "products_count": 0,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238",
    "image": {
      "created_at": "2018-11-13T11:45:04-05:00",
      "alt": "iPod Nano 8gb",
      "width": 123,
      "height": 456,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/ipod_nano_8gb.jpg?v=1542127504"
    }
  }
}
POST /admin/smart_collections.json
Creates a new smart collection.
Valid values for each rule field:
  • column: tag, title, type, vendor, variant_price, variant_compare_at_price, variant_weight, variant_inventory, variant_title
  • relation: equals, greater_than, less_than, starts_with, ends_with, contains
  • condition: any string

Create a smart collection of all products starting with the specified term

POST /admin/smart_collections.json
{
  "smart_collection": {
    "title": "IPods",
    "rules": [
      {
        "column": "title",
        "relation": "starts_with",
        "condition": "iPod"
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "smart_collection": {
    "id": 1063001313,
    "handle": "ipods-1",
    "title": "IPods",
    "updated_at": "2018-11-13T11:45:30-05:00",
    "body_html": null,
    "published_at": "2018-11-13T11:45:30-05:00",
    "sort_order": "best-selling",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "title",
        "relation": "starts_with",
        "condition": "iPod"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/1063001313"
  }
}

Create a smart collection with a specified title

POST /admin/smart_collections.json
{
  "smart_collection": {
    "title": "Macbooks",
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "smart_collection": {
    "id": 1063001314,
    "handle": "macbooks",
    "title": "Macbooks",
    "updated_at": "2018-11-13T11:45:31-05:00",
    "body_html": null,
    "published_at": "2018-11-13T11:45:31-05:00",
    "sort_order": "best-selling",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/1063001314"
  }
}

Create a new unpublished smart collection

POST /admin/smart_collections.json
{
  "smart_collection": {
    "title": "Macbooks",
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ],
    "published": false
  }
}
View Response
HTTP/1.1 201 Created
{
  "smart_collection": {
    "id": 1063001315,
    "handle": "macbooks",
    "title": "Macbooks",
    "updated_at": "2018-11-13T11:45:31-05:00",
    "body_html": null,
    "published_at": null,
    "sort_order": "best-selling",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/1063001315"
  }
}

Create a new smart collection with a base64 encoded image

POST /admin/smart_collections.json
{
  "smart_collection": {
    "title": "Macbooks",
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ],
    "image": {
      "attachment": "R0lGODlhAQABAIAAAAAAAAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==\n",
      "alt": "iPod"
    }
  }
}
View Response
HTTP/1.1 201 Created
{
  "smart_collection": {
    "id": 1063001316,
    "handle": "macbooks",
    "title": "Macbooks",
    "updated_at": "2018-11-13T11:45:32-05:00",
    "body_html": null,
    "published_at": "2018-11-13T11:45:32-05:00",
    "sort_order": "best-selling",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/1063001316",
    "image": {
      "created_at": "2018-11-13T11:45:32-05:00",
      "alt": "iPod",
      "width": 1,
      "height": 1,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1542127532"
    }
  }
}

Create a new smart collection with an image that will be downloaded by Shopify

POST /admin/smart_collections.json
{
  "smart_collection": {
    "title": "Macbooks",
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ],
    "image": {
      "src": "http://example.com/rails_logo.gif",
      "alt": "Rails Logo"
    }
  }
}
View Response
HTTP/1.1 201 Created
{
  "smart_collection": {
    "id": 1063001317,
    "handle": "macbooks",
    "title": "Macbooks",
    "updated_at": "2018-11-13T11:45:33-05:00",
    "body_html": null,
    "published_at": "2018-11-13T11:45:32-05:00",
    "sort_order": "best-selling",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/1063001317",
    "image": {
      "created_at": "2018-11-13T11:45:32-05:00",
      "alt": "Rails Logo",
      "width": 110,
      "height": 140,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/rails_logo20181113-9087-1gtoivm.gif?v=1542127533"
    }
  }
}

Creating a smart collection without a title will return an error

POST /admin/smart_collections.json
{
  "smart_collection": {
    "body": "foobar",
    "rules": [
      {
        "column": "vendor",
        "relation": "equals",
        "condition": "Apple"
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "title": [
      "can't be blank"
    ]
  }
}
PUT /admin/smart_collections/482865238.json
Updates an existing smart collection

Update the description of a smart collection

PUT /admin/smart_collections/#{smart_collection_id}.json
{
  "smart_collection": {
    "id": 482865238,
    "body_html": "<p>5000 songs in your pocket</p>"
  }
}
View Response
HTTP/1.1 200 OK
{
  "smart_collection": {
    "id": 482865238,
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2018-11-13T11:45:33-05:00",
    "body_html": "<p>5000 songs in your pocket</p>",
    "published_at": "2008-02-01T19:00:00-05:00",
    "sort_order": "manual",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238",
    "image": {
      "created_at": "2018-11-13T11:45:04-05:00",
      "alt": "iPod Nano 8gb",
      "width": 123,
      "height": 456,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/ipod_nano_8gb.jpg?v=1542127504"
    }
  }
}

Show a hidden collection

PUT /admin/smart_collections/#{smart_collection_id}.json
{
  "smart_collection": {
    "id": 482865238,
    "published": true
  }
}
View Response
HTTP/1.1 200 OK
{
  "smart_collection": {
    "id": 482865238,
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2018-11-13T11:45:34-05:00",
    "body_html": "<p>The best selling ipod ever</p>",
    "published_at": "2018-11-13T11:45:34-05:00",
    "sort_order": "manual",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238",
    "image": {
      "created_at": "2018-11-13T11:45:04-05:00",
      "alt": "iPod Nano 8gb",
      "width": 123,
      "height": 456,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/ipod_nano_8gb.jpg?v=1542127504"
    }
  }
}

Hide a published smart collection

PUT /admin/smart_collections/#{smart_collection_id}.json
{
  "smart_collection": {
    "id": 482865238,
    "published": false
  }
}
View Response
HTTP/1.1 200 OK
{
  "smart_collection": {
    "id": 482865238,
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2018-11-13T11:45:35-05:00",
    "body_html": "<p>The best selling ipod ever</p>",
    "published_at": null,
    "sort_order": "manual",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238",
    "image": {
      "created_at": "2018-11-13T11:45:04-05:00",
      "alt": "iPod Nano 8gb",
      "width": 123,
      "height": 456,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/ipod_nano_8gb.jpg?v=1542127504"
    }
  }
}

Update a smart collection by setting a new collection image

PUT /admin/smart_collections/#{smart_collection_id}.json
{
  "smart_collection": {
    "id": 482865238,
    "image": {
      "attachment": "R0lGODlhbgCMAPf/APbr48VySrxTO7IgKt2qmKQdJeK8lsFjROG5p/nz7Zg3\nMNmnd7Q1MLNVS9GId71hSJMZIuzTu4UtKbeEeakhKMl8U8WYjfr18YQaIbAf\nKKwhKdKzqpQtLebFortOOejKrOjZ1Mt7aMNpVbAqLLV7bsNqR+3WwMqEWenN\nsZYxL/Ddy/Pm2e7ZxLlUQrIjNPXp3bU5MbhENbEtLtqhj5ZQTfHh0bMxL7Ip\nNsNyUYkZIrZJPcqGdYIUHb5aPKkeJnoUHd2yiJkiLKYiKLRFOsyJXKVDO8up\nosFaS+TBnK4kKti5sNaYg/z49aqYl5kqLrljUtORfMOlo/36+H4ZH8yDYq0f\nKKFYTaU9MrY8MrZBNXwXHpgaIdGVYu/byLZNP9SaZLIyOuXCtHkpJst+Wpcm\nLMyCa8BfP9GMb9KQdPDd1PPk1sd5VP79/L5dQZ0bI9+ymqssK9WcfIoXHdzG\nxdWWfteib79lSr1YP86MYurQxKdcUKdMQr5ZSfPs6YEZH8uhl4oWIenMuurQ\nttmejaqoqsqBVaAcJLlJN5kvMLlZRMNsSL5fRak0LbdQQMVvSPjw6cJnRpkf\nKtmjhvfu5cJtT7IuOMVvWLY/M/37+o0YH9ibhtSYdObErc6HarM9NnYSGNGR\navLi09unje3WyeO8rsVrT7tdRtK3uffu6NWeaL9pTJIjJrM4NPbx8cdyX7M7\nPYYVHu7j4KgoNJAYIKtkV5o9MsOcldicis+RYNutfrhFOZ0hJbqinZ8bI8h5\nUObFuOfItJsfJrJfUOfIqc+PXqQtK8RnSbA4Mcd3Tm0SGbpXQ8aqp7RLNs+s\novHfzpVhV9iggMd1TLtbRKUdKXEQFsd4XrZRPLIgMZUeJ+jKvrAlK6AhJ65A\nMpMpKuC3j5obIsRwS7hAN8l/YtvDvnYXHbAoLI47SIUsOMenorF4gO/m4+fH\npo4vLZ8oKMukqp0cJbhVSMV2UuPR0bAfMLIrLrg/OcJwT8h+Vt+wn8eurLlh\nQrIfKHQOHHQOHf///////yH5BAEAAP8ALAAAAABuAIwAAAj/AP8JHDhQXjpz\n/PopXNiPn0OHDRMmbKhQIsOJFS1SxAhxI8SHFzVeDBnx48iNBAeeOkcxokeX\nFRdOnAlSokaaLXNujJkxo8iYHRkKtWkzZSsaOXkAWsoUECynsHgoqEW1qtVa\n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\nGg4lOnRGDKRZsoS7pMPSA6YXNWLsKJLkSZOVwKhMGSTTrJf9ZNKcomXKTrQY\nevr02cSIvKJxi6aJkaVuXaZMs1ziO5UqPawnuXK9AWEW2Jhja9pMuzMd27YW\nLNga10fuZYUPkdZdqpTv575YbJQbkCHw1sEpb9wQMstwWLFkbfppjJPc/wTI\nhHhJ5r0BBGbMRzfb7ez5MwwbpTMsx5pa9eob2CBM5yETpmzGtTE8hrybN29b\nc1oBn6trc9K7nhmUy6BcOUrn0KHLcr0FQvWYMxdnb3w7t/fvwFMiFvKG0uw8\n4kRLYjkGG0RtMPlWc+GGdyCwbwtYrOsHu7K0a+K/AEO04K0CF8InBvPOg2GE\nKpZTrsHSUotwwgnnmW4LHGGBKbb9bMqhsSly082CW0QMkDLLSvQHFQFiOESX\nLGzQpkUY22swA8Lko9EFLqfBEcdvMhRrwx610OLHtJ5Rc01ahHnCzTeFkXNO\nOfWQkwQ6NNFzTz2X0GQJQAMVdJEYsBhBAyrbK/9tgBcbrCTCG7bkkstvvvwm\nzPzI7JEcNLXDCYICQhXVkAIMMdWQd0x1Y9VdiuHGA1hjhfWQQzyg9dZDYmBg\nyioSVfRKFwfYZ8ZIJ3XhGhe83OLSSwEZU78ea+pUO2wK8MFaUUMl9dReDOll\n1VXbuYIZWWOl1dZDLpGhV3YZXLTR9vZhUMJijUX2mmveYRZcQDLlsCZOp21s\nCx+uLTjbbE/11ttv3diFkSHKRReGcthtN1hgrdxH2Awk5fJefK+ZZ9lvVvXW\n2cT+ZSwHgdHCpmCYDb4WYVNL7baXbsN9FdYYbKDA4otddBdYeffZx9iPjw35\nmmlKNtnUfmXSNNqAW9b/6eWYY8YWYW0V7tYQhxWAwwege61y6OXkbdDoSUFe\nWuR3wP3akKhjUtlHlqklG+YqsjaY620VNgQDMcQQouwrX3zR6KKFZfttyKtw\n+utQnRUL2mjLYjnvtLDpu9e9/ZYZ8FK3maLwwn8OmlF3lWNc7df3gfzteaZZ\n+NTKx5y6RxJ69/333mvBwHOLQ/fhiR2SV34HS47hmnAafJ9gh3AaDMcB7LE/\nIoPY441dhOzDz94VN3DPNmoeM5drAyfK7lWH34baYetVCidBIT6C5UMhB4r2\nn3FheSANRVGCwhBmObtlbgqXyYYNyuYFAMQFCtPwQf3spxAraGBRR+Af91wX\n/zsPoCIuCCAV13yAMsWo7zIOaJHFSHEZHZABdWK4X0JoIAENLIeDCXFA2rgX\nuwG8MC6kKGGoZuaDTEhtd/vBTBoyYLYqeAEzFpihGCagEBqIQQJVGMAOEdLD\n2L0uHJdBAMIOhsTELHExwLnS/i6zAQlIQItWxKIccejGL/4wjPvw4kHSQApA\nBhKQUDCiEWE2C93dTSEW2EMjaWABhbgnA3g8SAj4cElK+kMJWoyjBK6YECtw\nUgKZ7N8ejdZHfzjgGgNY5SpnZsisJXFHikwICTLBskzUECFtxJ/FFKKETmrx\nkwixQiclYAX+mfKUCpnBEZzpzHpkS2Yxm0ViMNcjhf+QABs5uKUuD9KoTOaP\nQb80picxaExk8lCZfIxLNuBhrWnurZpjoiVCbAkBbnrTH2pbTjgZVAVyGnOY\nBylmJ9P5xXWOUS6WEB3ZqgmTazLxMk40WntQub3lbIOc7OjkQP1RUI4e9CCl\nfJ3jjCbEogDAE6KrAiKlVs+4gJF7GUDlDLLnUWCyg6Ps8GgxdyrSVK5zH/WI\noARjZjFEQhSmRCEFg9SGSqIoQadT7alOJcAOoJJUmeFA6VBIETqk+ssPKizK\nDorxwx9CdShSvapOqzpVoO7ApMocgAdcIb74HeSroEOqEn8w1mgVRR0KyEEw\nKqoctTZEquzggFsVooepskP/DwqZAAfmakpGvc4HXSXF54CWVLthALASRYhB\nFpmDd4QxsQxRQmNd61HITnWyCVHC9MTnCsY9U7dH4AM8spGQvVrsiRB4Fg/8\ncFxsJmQDHvUHLQyhWsy01rXs2MFj2ZGC6862KKRgHGY6K9zlEPdyP8AJcteo\n3ClsQCHq0AF0QdkN+HbjlxygL31hO13tMrW7lwkB0BiUoR3x4EfmrYlCNjAF\nCRAoIWmwQexQqQcyxHe+9eXAfVOQAg7k16v7jQsAHGi2Bv0gUzyQQ05Ga+Cy\n0MBEDsZgN8gQ4QnXt7oJ0QOGOZACDTeEu0aTCwC80EKhDcAHMDGHWATMsuMC\nFsVl/9GnP0Jg0kw24MUv/qUTOGDlCj8WETfGsVx2vI+UzsATIFZUaTIRk3QY\n+ZYlFq0Ce5QJHBXgdU+MRCSwEYlVBCHPQZhyn7vhhD9fWdAc2DKhKXxhRCc6\n0Yi4LOPcl6hGVUFqc4gJLGaxufKO1s2VkrOj63znOkciCKMedZ+n7ARUp1rQ\niLAyIlyNYURcONaInrWs9ci4JyJOaFYawDzP8Q+ZwAICLckbgd08i290eh9V\nCIadQw3qO5Oa1H1GNRlSjeorO2HLruZ2rLudAm+Dm9Gxcx/GXmSIMbnjH5W2\nzy2RbOzM+cENBRAWs0N9b3zXWdp8pra1r61tbXdb4N/2Nv8i5gzeIJd5Gjui\nwT+AzQ9YVGrYnNO0Agm27GBkvNnNzje+921qf/+b1QEfuMDFPe5lk/lspUG3\nWKbQCofLBBBuwNEs3C3aikcrB2TTeM81HgmOd3zf/PZ3yFPNaqSXfODF0EDK\nE9e6liZmCvJwOLD7AQhU2efSbG6zm7VgiG1ofBc+//nGgZ7vbYw67aVux4v/\nfXSSK53by/HVrzIwDZTBBANUrzpMeAAIWASeB4P/AQ9+cHjEJx7xWgDE5nLQ\neMdHXvKbg/zkMZ23H/1oFRjYPOc9v3nQ58Aw0xn9LACvO7HQAOZVf/jl0ii1\nHcXe9bPX3euftaPL5R71tIf97nsy7/o0WlP2r4/JOU7B+r5nqva7jz1EdZ97\n4qNe+bonfvCfVXvly1762beOOdLBd+Q7PCAAOw==\n",
      "alt": "Rails logo"
    }
  }
}
View Response
HTTP/1.1 200 OK
{
  "smart_collection": {
    "id": 482865238,
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2018-11-13T11:45:36-05:00",
    "body_html": "<p>The best selling ipod ever</p>",
    "published_at": "2008-02-01T19:00:00-05:00",
    "sort_order": "manual",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238",
    "image": {
      "created_at": "2018-11-13T11:45:36-05:00",
      "alt": "Rails logo",
      "width": 110,
      "height": 140,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/fd43f2c8883f6e9b680e3295fd990d2c.gif?v=1542127536"
    }
  }
}

Update a smart collection by setting a new collection image alternative text

PUT /admin/smart_collections/#{smart_collection_id}.json
{
  "smart_collection": {
    "id": 482865238,
    "image": {
      "alt": "Rails logo"
    }
  }
}
View Response
HTTP/1.1 200 OK
{
  "smart_collection": {
    "id": 482865238,
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2018-11-13T11:45:37-05:00",
    "body_html": "<p>The best selling ipod ever</p>",
    "published_at": "2008-02-01T19:00:00-05:00",
    "sort_order": "manual",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238",
    "image": {
      "created_at": "2018-11-13T11:45:36-05:00",
      "alt": "Rails logo",
      "width": 110,
      "height": 140,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/collections/rails_logo20181113-9087-zgn7mj.gif?v=1542127537"
    }
  }
}

Update a smart collection by clearing the collection image

PUT /admin/smart_collections/#{smart_collection_id}.json
{
  "smart_collection": {
    "id": 482865238,
    "image": "",
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2018-11-13T11:45:37-05:00",
    "body_html": "<p>The best selling ipod ever</p>",
    "published_at": "2008-02-01T19:00:00-05:00",
    "sort_order": "manual",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238"
  }
}
View Response
HTTP/1.1 200 OK
{
  "smart_collection": {
    "id": 482865238,
    "handle": "smart-ipods",
    "title": "Smart iPods",
    "updated_at": "2018-11-13T11:45:38-05:00",
    "body_html": "<p>The best selling ipod ever</p>",
    "published_at": "2008-02-01T19:00:00-05:00",
    "sort_order": "manual",
    "template_suffix": null,
    "disjunctive": false,
    "rules": [
      {
        "column": "type",
        "relation": "equals",
        "condition": "Cult Products"
      }
    ],
    "published_scope": "web",
    "admin_graphql_api_id": "gid://shopify/Collection/482865238"
  }
}
PUT /admin/smart_collections/482865238/order.json
Updates the ordering type of products in a smart collection
products

An array of product IDs, in the order that you want them to appear at the top of the collection. As of 2019, it will be possible to order a subset of products manually for collections with any sort order (limited to the first 250 products in a collection). When products is specified but empty, any previously sorted products are cleared.

sort_order

The type of sorting to apply. Valid values are listed in the Properties section above.

(default: (current value))

Update manually-sorted products in the smart collection

PUT /admin/smart_collections/#{smart_collection_id}/order.json?products[]=921728736&products[]=632910392
{
}
View Response
HTTP/1.1 200 OK
{
}

Update the type of ordering applied to the smart collection

PUT /admin/smart_collections/#{smart_collection_id}/order.json?sort_order=alpha-desc
{
}
View Response
HTTP/1.1 200 OK
{
}
DELETE /admin/smart_collections/482865238.json
Removes a smart collection

Remove a smart collection

DELETE /admin/smart_collections/#{smart_collection_id}.json
View Response
HTTP/1.1 200 OK
{
}
GET /admin/smart_collections/482865238/products.json
Retrieves a list of products in a smart collection. By default, the collection's manually-sorted products are listed first, followed by its automatically-sorted products.
only_sorted

Return only the indicated products.

(default: all)
  • only_manual: Return only manually-sorted products.
  • only_automatic: Return only automatically-sorted products.
  • all: Return all the collection's products.
after

Returns the elements that come after the specified cursor.

before

Returns the elements that come before the specified cursor.

Retrieve the collections manually-sorted products

GET /admin/smart_collections/#{smart_collection_id}/products.json?only_sorted=only_manual
View Response
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2018-11-13T11:45:04-05:00",
      "handle": "ipod-nano",
      "updated_at": "2018-11-13T11:45:04-05:00",
      "published_at": "2007-12-31T19:00:00-05:00",
      "template_suffix": null,
      "tags": "Emotive, Flash Memory, MP3, Music",
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Product/632910392",
      "variants": [
        {
          "id": 808950810,
          "product_id": 632910392,
          "title": "Pink",
          "price": "199.00",
          "sku": "IPOD2008PINK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Pink",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_pink",
          "grams": 567,
          "image_id": 562641783,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 808950810,
          "inventory_quantity": 10,
          "old_inventory_quantity": 10,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
        },
        {
          "id": 49148385,
          "product_id": 632910392,
          "title": "Red",
          "price": "199.00",
          "sku": "IPOD2008RED",
          "position": 2,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Red",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_red",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 49148385,
          "inventory_quantity": 20,
          "old_inventory_quantity": 20,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
        },
        {
          "id": 39072856,
          "product_id": 632910392,
          "title": "Green",
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "position": 3,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Green",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_green",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 39072856,
          "inventory_quantity": 30,
          "old_inventory_quantity": 30,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
        },
        {
          "id": 457924702,
          "product_id": 632910392,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "position": 4,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 457924702,
          "inventory_quantity": 40,
          "old_inventory_quantity": 40,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
        }
      ],
      "options": [
        {
          "id": 594680422,
          "product_id": 632910392,
          "name": "Color",
          "position": 1,
          "values": [
            "Pink",
            "Red",
            "Green",
            "Black"
          ]
        }
      ],
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1542127504",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1542127504",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ],
      "image": {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2018-11-13T11:45:04-05:00",
        "updated_at": "2018-11-13T11:45:04-05:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1542127504",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      },
      "cursor": "eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjYzMjkxMDM5MiwibGFzdF92YWx1ZSI6Wzk5OTk5LjAsM10sImRpcmVjdGlvbiI6Im5leHQifQ==--8145cad6f8aece227073562a4e2f27b214f0dee1",
      "manually_sorted": true
    }
  ]
}

Retrieve the collections automatically-sorted products

GET /admin/smart_collections/#{smart_collection_id}/products.json?only_sorted=only_automatic
View Response
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "body_html": "<p>The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2018-11-13T11:45:04-05:00",
      "handle": "ipod-touch",
      "updated_at": "2018-11-13T11:45:04-05:00",
      "published_at": "2008-09-25T20:00:00-04:00",
      "template_suffix": null,
      "tags": "",
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Product/921728736",
      "variants": [
        {
          "id": 447654529,
          "product_id": 921728736,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "shipwire-app",
          "inventory_management": "shipwire-app",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 447654529,
          "inventory_quantity": 13,
          "old_inventory_quantity": 13,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/447654529"
        }
      ],
      "options": [
        {
          "id": 891236591,
          "product_id": 921728736,
          "name": "Title",
          "position": 1,
          "values": [
            "Black"
          ]
        }
      ],
      "images": [],
      "image": null,
      "cursor": "eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjkyMTcyODczNiwibGFzdF92YWx1ZSI6MCwiZGlyZWN0aW9uIjoibmV4dCJ9--0e863512377a9b32e1b98df7d45fcec616b62fe1",
      "manually_sorted": false
    }
  ]
}

Retrieve all the collections products by specifying all

GET /admin/smart_collections/#{smart_collection_id}/products.json?only_sorted=all
View Response
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2018-11-13T11:45:04-05:00",
      "handle": "ipod-nano",
      "updated_at": "2018-11-13T11:45:04-05:00",
      "published_at": "2007-12-31T19:00:00-05:00",
      "template_suffix": null,
      "tags": "Emotive, Flash Memory, MP3, Music",
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Product/632910392",
      "variants": [
        {
          "id": 808950810,
          "product_id": 632910392,
          "title": "Pink",
          "price": "199.00",
          "sku": "IPOD2008PINK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Pink",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_pink",
          "grams": 567,
          "image_id": 562641783,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 808950810,
          "inventory_quantity": 10,
          "old_inventory_quantity": 10,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
        },
        {
          "id": 49148385,
          "product_id": 632910392,
          "title": "Red",
          "price": "199.00",
          "sku": "IPOD2008RED",
          "position": 2,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Red",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_red",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 49148385,
          "inventory_quantity": 20,
          "old_inventory_quantity": 20,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
        },
        {
          "id": 39072856,
          "product_id": 632910392,
          "title": "Green",
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "position": 3,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Green",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_green",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 39072856,
          "inventory_quantity": 30,
          "old_inventory_quantity": 30,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
        },
        {
          "id": 457924702,
          "product_id": 632910392,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "position": 4,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 457924702,
          "inventory_quantity": 40,
          "old_inventory_quantity": 40,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
        }
      ],
      "options": [
        {
          "id": 594680422,
          "product_id": 632910392,
          "name": "Color",
          "position": 1,
          "values": [
            "Pink",
            "Red",
            "Green",
            "Black"
          ]
        }
      ],
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1542127504",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1542127504",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ],
      "image": {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2018-11-13T11:45:04-05:00",
        "updated_at": "2018-11-13T11:45:04-05:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1542127504",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      },
      "cursor": "eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjYzMjkxMDM5MiwibGFzdF92YWx1ZSI6Wzk5OTk5LjAsM10sImRpcmVjdGlvbiI6Im5leHQifQ==--8145cad6f8aece227073562a4e2f27b214f0dee1",
      "manually_sorted": true
    },
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "body_html": "<p>The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2018-11-13T11:45:04-05:00",
      "handle": "ipod-touch",
      "updated_at": "2018-11-13T11:45:04-05:00",
      "published_at": "2008-09-25T20:00:00-04:00",
      "template_suffix": null,
      "tags": "",
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Product/921728736",
      "variants": [
        {
          "id": 447654529,
          "product_id": 921728736,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "shipwire-app",
          "inventory_management": "shipwire-app",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 447654529,
          "inventory_quantity": 13,
          "old_inventory_quantity": 13,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/447654529"
        }
      ],
      "options": [
        {
          "id": 891236591,
          "product_id": 921728736,
          "name": "Title",
          "position": 1,
          "values": [
            "Black"
          ]
        }
      ],
      "images": [],
      "image": null,
      "cursor": "eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjkyMTcyODczNiwibGFzdF92YWx1ZSI6WzAuMCwwXSwiZGlyZWN0aW9uIjoibmV4dCJ9--febf010c76cddf8b5b703d8b6f9c3eaafe5ee7c7",
      "manually_sorted": false
    }
  ]
}

Retrieve the products that come after the specified cursor

GET /admin/smart_collections/#{smart_collection_id}/products.json?after=eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjYzMjkxMDM5MiwibGFzdF92YWx1ZSI6WzAuMCwzXSwiZGlyZWN0aW9uIjoibmV4dCJ9--86ee39f2c9a3a8491c2d751f3a5968411dd24c1b&only_sorted=all
View Response
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "body_html": "<p>The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2018-11-13T11:45:04-05:00",
      "handle": "ipod-touch",
      "updated_at": "2018-11-13T11:45:04-05:00",
      "published_at": "2008-09-25T20:00:00-04:00",
      "template_suffix": null,
      "tags": "",
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Product/921728736",
      "variants": [
        {
          "id": 447654529,
          "product_id": 921728736,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "shipwire-app",
          "inventory_management": "shipwire-app",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 447654529,
          "inventory_quantity": 13,
          "old_inventory_quantity": 13,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/447654529"
        }
      ],
      "options": [
        {
          "id": 891236591,
          "product_id": 921728736,
          "name": "Title",
          "position": 1,
          "values": [
            "Black"
          ]
        }
      ],
      "images": [],
      "image": null,
      "cursor": "eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjkyMTcyODczNiwibGFzdF92YWx1ZSI6WzAuMCwwXSwiZGlyZWN0aW9uIjoibmV4dCJ9--febf010c76cddf8b5b703d8b6f9c3eaafe5ee7c7",
      "manually_sorted": false
    }
  ]
}

Retrieve the products that come before the specified cursor

GET /admin/smart_collections/#{smart_collection_id}/products.json?before=eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjkyMTcyODczNiwibGFzdF92YWx1ZSI6WzAuMCwwXSwiZGlyZWN0aW9uIjoibmV4dCJ9--febf010c76cddf8b5b703d8b6f9c3eaafe5ee7c7&only_sorted=all
View Response
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2018-11-13T11:45:04-05:00",
      "handle": "ipod-nano",
      "updated_at": "2018-11-13T11:45:04-05:00",
      "published_at": "2007-12-31T19:00:00-05:00",
      "template_suffix": null,
      "tags": "Emotive, Flash Memory, MP3, Music",
      "published_scope": "web",
      "admin_graphql_api_id": "gid://shopify/Product/632910392",
      "variants": [
        {
          "id": 808950810,
          "product_id": 632910392,
          "title": "Pink",
          "price": "199.00",
          "sku": "IPOD2008PINK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Pink",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_pink",
          "grams": 567,
          "image_id": 562641783,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 808950810,
          "inventory_quantity": 10,
          "old_inventory_quantity": 10,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
        },
        {
          "id": 49148385,
          "product_id": 632910392,
          "title": "Red",
          "price": "199.00",
          "sku": "IPOD2008RED",
          "position": 2,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Red",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_red",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 49148385,
          "inventory_quantity": 20,
          "old_inventory_quantity": 20,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
        },
        {
          "id": 39072856,
          "product_id": 632910392,
          "title": "Green",
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "position": 3,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Green",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_green",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 39072856,
          "inventory_quantity": 30,
          "old_inventory_quantity": 30,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
        },
        {
          "id": 457924702,
          "product_id": 632910392,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "position": 4,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 457924702,
          "inventory_quantity": 40,
          "old_inventory_quantity": 40,
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
        }
      ],
      "options": [
        {
          "id": 594680422,
          "product_id": 632910392,
          "name": "Color",
          "position": 1,
          "values": [
            "Pink",
            "Red",
            "Green",
            "Black"
          ]
        }
      ],
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1542127504",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2018-11-13T11:45:04-05:00",
          "updated_at": "2018-11-13T11:45:04-05:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1542127504",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ],
      "image": {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2018-11-13T11:45:04-05:00",
        "updated_at": "2018-11-13T11:45:04-05:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1542127504",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      },
      "cursor": "eyJsaW1pdCI6NTAsInNvcnRfZmllbGRzIjoibGluZV9pdGVtc19jb3VudCIsInNvcnRfZGlyIjoiZGVzYyIsImxhc3RfaWQiOjYzMjkxMDM5MiwibGFzdF92YWx1ZSI6WzAuMCwzXSwiZGlyZWN0aW9uIjoibmV4dCJ9--86ee39f2c9a3a8491c2d751f3a5968411dd24c1b",
      "manually_sorted": false
    }
  ]
}

Sign up for a Partner account to get started.

Sign up