# SmartCollection

        <p>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.</p>
        <p>By default, a store can have up to 5000 smart collections.</p>
        <p>The <a href="/docs/admin-api/rest/reference/products/collect">Collect</a> 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.</p> {{ '/api/reference/smart-collection.png' | image }}
        <p>You can use the <a href="/docs/admin-api/rest/reference/products/customcollection">CustomCollection</a> resource
        to work with collections where each product in the collection is manually chosen by the merchant.</p>

## Resource Properties

### SmartCollection

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

  * Type: x-string
  * Example: "<p>The best selling ipod ever</p>"
* handle:           A human-friendly unique string for the smart collection. Automatically generated from the <code>title</code>.
          Used in shop themes by the Liquid templating language to refer to the smart collection. (maximum: 255 characters)

  * Type: x-string
  * Example: "smart-ipods"
* id: The ID of the smart collection.
  * Type: x-string
  * Example: 482865238
* image:           <p>The image associated with the smart collection. Valid values:</p>
          <ul>
            <li><code>attachment</code>: An image attached to a smart collection returned as Base64-encoded binary data.</li>
            <li><code>src</code>: A URL that specifies the location of the image.</li>
            <li><code>alt</code>: Alternative text that describes the collection image.</li>
          </ul>

  * Type: x-string
  * Example: {"src"=>"http://static.shopify.com/collections/ipod.jpg?0", "alt"=>"iPods"}
* published_at:           The date and time (<a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 format</a>)
          that the smart collection was published. Returns <code>null</code> when the collection is hidden.

  * Type: x-string
  * Example: "2008-02-01T19:00:00-05:00"
* published_scope:           Whether the smart collection is published to the Point of Sale channel. Valid values:
          <ul>
            <li><code>web</code>: The smart collection is published to the Online Store channel but not published to the Point of Sale channel.</li>
            <li><code>global</code>: The smart collection is published to both the Online Store channel and the Point of Sale channel.</li>
          </ul>

  * Type: x-string
  * Example: "global"
* rules:           <p>The list of rules that define what products go into the smart collection. Each rule has the following properties:</p>
          <ul>
            <li><p><strong>column</strong>: The property of a product being used to populate the smart collection.</p>
              <p>Valid values for text relations:
              <ul>
                <li><code>title</code>: The product title.</li>
                <li><code>type</code>: The product type.</li>
                <li><code>vendor</code>: The name of the product vendor.</li>
                <li><code>variant_title</code>: The title of a product variant.</li>
              </ul>
              <p>Valid values for number relations:</p>
              <ul>
                <li><code>variant_compare_at_price</code>: The compare price.</li>
                <li><code>variant_weight</code>: The weight of the product.</li>
                <li><code>variant_inventory</code>: The inventory stock. Note: <code>not_equals</code> does not work with this property.</li>
                <li><code>variant_price</code>: product price.</li>
              </ul>
              <p>Valid values for an <code>equals</code> relation:
                <ul>
                  <li><code>tag</code>: A tag associated with the product.</li>
                </ul>
              <p>Valid values for metafield definition relations:
                <ul>
                  <li><code>product_metafield_definition</code>: When the metafield definition rule is powered by a product metafield definition.</li>
                  <li><code>variant_metafield_definition</code>: When the metafield definition rule is powered by a variant metafield definition.</li>
                </ul>
            </li>
            <li><p><strong>relation</strong>: The relationship between the <strong>column</strong> choice, and the <strong>condition</strong>.</p>
              <p>Valid values for number relations:</p>
              <ul>
                <li><code>greater_than</code> The column value is greater than the condition.</li>
                <li><code>less_than</code> The column value is less than the condition.</li>
                <li><code>equals</code> The column value is equal to the condition.</li>
                <li><code>not_equals</code> The column value is not equal to the condition.</li>
              </ul>
              <p>Valid values for text relations:</p>
              <ul>
                <li><code>equals</code>: Checks if the <strong>column</strong> value is equal to the <strong>condition</strong> value.</li>
                <li><code>not_equals</code>: Checks if the <strong>column</strong> value is not equal to the <strong>condition</strong> value.</li>
                <li><code>starts_with</code>: Checks if the <strong>column</strong> value starts with the <strong>condition</strong> value.</li>
                <li><code>ends_with</code>: Checks if the <strong>column</strong> value ends with the <strong>condition</strong> value.</li>
                <li><code>contains</code>: Checks if the <strong>column</strong> value contains the <strong>condition</strong> value.</li>
                <li><code>not_contains</code>: Checks if the <strong>column</strong> value does not contain the <strong>condition</strong> value.</li>
              </ul>
              <p>Valid values for metafield relations are based on the corresponding metafield definition type. The following definition types support the listed relations</p>
              <ul>
                <li><code>rating</code>: <code>equals</code>, <code>greater_than</code>, <code>less_than</code></li>
                <li><code>boolean</code>: <code>equals</code></li>
                <li><code>number_integer</code>: <code>equals</code>, <code>greater_than</code>, <code>less_than</code></li>
                <li><code>number_decimal</code>: <code>equals</code>, <code>greater_than</code>, <code>less_than</code></li>
                <li><code>single_line_text_field</code>: <code>equals</code></li>
                <li><code>list.single_line_text_field</code>: <code>equals</code></li>
              </ul>
            </li>
            <li><p><strong>condition</strong>: Select products for a smart collection using a condition. Values are either strings or numbers, depending on the <strong>relation</strong> value.</p>
            <li><p><strong>condition_object_id</strong>: The object id that points to additional attributes for the collection rule. This is only required when using metafield definition rules.</p>
            </li>
          </ul>

  * Type: x-string
  * Example: {"column"=>"variant_price", "relation"=>"less_than", "condition"=>"20"}
* disjunctive:           Whether the product must match all the rules to be included in the smart collection. Valid values:
          <ul>
            <li><code>true</code>: Products only need to match one or more of the rules to be included in the smart collection.</li>
            <li><code>false</code>: Products must match all of the rules to be included in the smart collection.</li>
          </ul>

  * Type: x-string
  * Example: false
* sort_order:           <p>The order of the products in the smart collection. Valid values:</p>
          <ul>
           <li><code>alpha-asc</code>: The products are sorted alphabetically from A to Z.</li>
           <li><code>alpha-des</code>: The products are sorted alphabetically from Z to A.</li>
           <li><code>best-selling</code>: The products are sorted by number of sales.</li>
           <li><code>created</code>: The products are sorted by the date they were created, from oldest to newest.</li>
           <li><code>created-desc</code>: The products are sorted by the date they were created, from newest to oldest.</li>
           <li><code>manual</code>: The products are manually sorted by the shop owner.</li>
           <li><code>price-asc</code>: The products are sorted by price from lowest to highest.</li>
           <li><code>price-desc</code>: The products are sorted by price from highest to lowest.</li>
          </ul>

  * Type: x-string
  * Example: "alpha-asc"
* template_suffix:           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.<code>suffix</code>.liquid.

  * Type: x-string
  * Example: nil
* title: The name of the smart collection. Maximum length: 255 characters.
  * Type: x-string
  * Example: "Smart iPods"
* updated_at:           The date and time (<a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 format</a>) when the smart collection was last modified.

  * Type: x-string
  * Example: "2008-02-01T19:00:00-05:00"
## Retrieves a list of smart collections

Retrieves a list of smart collections. <strong>Note:</strong> This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to <a href='/api/usage/pagination-rest'>Make paginated requests to the REST Admin API</a>.

### Endpoint
/admin/api/#{api_version}/smart_collections.json?since_id=482865238 (GET)

### Parameters
* api_version (required): 
* fields: Show only certain fields, specified by a comma-separated list of field names.
* handle: Filter results by smart collection handle.
* ids: Show only the smart collections specified by a comma-separated list of IDs.
* limit: The number of results to show.
* product_id: Show smart collections that includes the specified product.
* published_at_max: Show smart collections published 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_status: Filter results based on the published status of smart collections.
* since_id: Restrict results to after the specified ID.
* title: Show smart collections with the specified title.
* updated_at_max: Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)
* updated_at_min: Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)

### Responses
#### 200
Retrieves a list of smart collections

Examples:
##### Retrieve a list all smart collections after a specified ID
Request:
```
GET /admin/api/unstable/smart_collections.json
```

Response:
```
HTTP/1.1 200 OK
{"smart_collections":[{"id":1063001328,"handle":"ipods-1","title":"IPods","updated_at":"2025-01-02T11:37:16-05:00","body_html":null,"published_at":"2025-01-02T11:37:16-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/1063001328"}]}
```
##### Retrieve a list of all smart collections
Request:
```
GET /admin/api/unstable/smart_collections.json
```

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":"2025-01-02T11:29:59-05:00","alt":"MP3 Player 8gb","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/ipod_nano_8gb.jpg?v=1735835399"}}]}
```
##### Retrieve a list of all smart collections for a certain product_id
Request:
```
GET /admin/api/unstable/smart_collections.json
```

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":"2025-01-02T11:29:59-05:00","alt":"MP3 Player 8gb","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/ipod_nano_8gb.jpg?v=1735835399"}}]}
```
##### Retrieve a list of specific smart collections
Request:
```
GET /admin/api/unstable/smart_collections.json
```

Response:
```
HTTP/1.1 200 OK
{"smart_collections":[{"id":1063001338,"handle":"macbooks","title":"Macbooks","updated_at":"2025-01-02T11:37:59-05:00","body_html":null,"published_at":"2025-01-02T11:37:59-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/1063001338"},{"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":"2025-01-02T11:29:59-05:00","alt":"MP3 Player 8gb","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/ipod_nano_8gb.jpg?v=1735835399"}}]}
```
## Retrieves a count of smart collections

Retrieves a count of smart collections

### Endpoint
/admin/api/#{api_version}/smart_collections/count.json (GET)

### Parameters
* api_version (required): 
* product_id: Show smart collections that include the specified product.
* published_at_max: Show smart collections published 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_status: Filter results based on the published status of smart collections.
* title: Show smart collections with the specified title.
* updated_at_max: Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)
* updated_at_min: Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)

### Responses
#### 200
Retrieves a count of smart collections

Examples:
##### Retrieve a count of all smart collections
Request:
```
GET /admin/api/unstable/smart_collections/count.json
```

Response:
```
HTTP/1.1 200 OK
{"count":1}
```
##### Retrieve a count of all smart collections for a certain product_id
Request:
```
GET /admin/api/unstable/smart_collections/count.json
```

Response:
```
HTTP/1.1 200 OK
{"count":1}
```
## Retrieves a single smart collection

Retrieves a single smart collection

### Endpoint
/admin/api/#{api_version}/smart_collections/{smart_collection_id}.json (GET)

### Parameters
* api_version (required): 
* smart_collection_id (required): 
* fields: Show only certain fields, specified by a comma-separated list of field names.

### Responses
#### 200
Retrieves a single smart collection

Examples:
##### Retrieve a specific collection by ID
Request:
```
GET /admin/api/unstable/smart_collections/482865238.json
```

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":2,"disjunctive":false,"rules":[{"column":"type","relation":"equals","condition":"Cult Products"}],"published_scope":"web","admin_graphql_api_id":"gid://shopify/Collection/482865238","image":{"created_at":"2025-01-02T11:29:59-05:00","alt":"MP3 Player 8gb","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/ipod_nano_8gb.jpg?v=1735835399"}}}
```
## Updates an existing smart collection

Updates an existing smart collection

### Endpoint
/admin/api/#{api_version}/smart_collections/{smart_collection_id}.json (PUT)

### Parameters
* api_version (required): 
* smart_collection_id (required): 

### Responses
#### 200
Updates an existing smart collection

Examples:
##### Hide a published smart collection
Request:
```
PUT /admin/api/unstable/smart_collections/482865238.json
{"smart_collection":{"id":482865238,"published":false}}
```

Response:
```
HTTP/1.1 200 OK
{"smart_collection":{"title":"Smart iPods","handle":"smart-ipods","body_html":"<p>The best selling ipod ever</p>","id":482865238,"published_at":null,"updated_at":"2025-01-02T11:37:48-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":"2025-01-02T11:29:59-05:00","alt":"MP3 Player 8gb","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/ipod_nano_8gb.jpg?v=1735835399"}}}
```
##### Publish a hidden collection
Request:
```
PUT /admin/api/unstable/smart_collections/482865238.json
{"smart_collection":{"id":482865238,"published":true}}
```

Response:
```
HTTP/1.1 200 OK
{"smart_collection":{"title":"Smart iPods","handle":"smart-ipods","body_html":"<p>The best selling ipod ever</p>","id":482865238,"published_at":"2025-01-02T11:37:18-05:00","updated_at":"2025-01-02T11:37:18-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":"2025-01-02T11:29:59-05:00","alt":"MP3 Player 8gb","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/ipod_nano_8gb.jpg?v=1735835399"}}}
```
##### Update a smart collection by clearing the collection image
Request:
```
PUT /admin/api/unstable/smart_collections/482865238.json
{"smart_collection":{"id":482865238,"image":"","updated_at":"2025-01-02T11:37:11-05:00","handle":"smart-ipods","title":"Smart iPods","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"}}
```

Response:
```
HTTP/1.1 200 OK
{"smart_collection":{"body_html":"<p>The best selling ipod ever</p>","handle":"smart-ipods","updated_at":"2025-01-02T11:37:12-05:00","id":482865238,"title":"Smart iPods","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"}}
```
##### Update a smart collection by setting a new collection image
Request:
```
PUT /admin/api/unstable/smart_collections/482865238.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"}}}
```

Response:
```
HTTP/1.1 200 OK
{"smart_collection":{"updated_at":"2025-01-02T11:37:31-05:00","id":482865238,"handle":"smart-ipods","title":"Smart iPods","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":"2025-01-02T11:37:31-05:00","alt":"Rails logo","width":110,"height":140,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/fd43f2c8883f6e9b680e3295fd990d2c.gif?v=1735835851"}}}
```
##### Update a smart collection by setting a new collection image alternative text
Request:
```
PUT /admin/api/unstable/smart_collections/482865238.json
{"smart_collection":{"id":482865238,"image":{"alt":"Rails logo"}}}
```

Response:
```
HTTP/1.1 200 OK
{"smart_collection":{"updated_at":"2025-01-02T11:37:23-05:00","id":482865238,"handle":"smart-ipods","title":"Smart iPods","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":{"alt":"Rails logo","created_at":"2025-01-02T11:37:20-05:00","width":110,"height":140,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/rails_logo20250102-63224-ol9r2i.gif?v=1735835843"}}}
```
##### Update the description of a smart collection
Request:
```
PUT /admin/api/unstable/smart_collections/482865238.json
{"smart_collection":{"id":482865238,"body_html":"<p>5000 songs in your pocket</p>"}}
```

Response:
```
HTTP/1.1 200 OK
{"smart_collection":{"body_html":"<p>5000 songs in your pocket</p>","title":"Smart iPods","handle":"smart-ipods","id":482865238,"updated_at":"2025-01-02T11:37:47-05:00","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":"2025-01-02T11:29:59-05:00","alt":"MP3 Player 8gb","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/ipod_nano_8gb.jpg?v=1735835399"}}}
```
## Removes a smart collection

Removes a smart collection

### Endpoint
/admin/api/#{api_version}/smart_collections/{smart_collection_id}.json (DELETE)

### Parameters
* api_version (required): 
* smart_collection_id (required): 

### Responses
#### 200
Removes a smart collection

Examples:
##### Remove a smart collection
Request:
```
DELETE /admin/api/unstable/smart_collections/482865238.json
```

Response:
```
HTTP/1.1 200 OK
{}
```
## Creates a smart collection

Creates a new smart collection using the specified rules.

### Endpoint
/admin/api/#{api_version}/smart_collections.json (POST)

### Parameters
* api_version (required): 

### Responses
#### 201
Creates a smart collection

Examples:
##### Create a new smart collection with a base64 encoded image
Request:
```
POST /admin/api/unstable/smart_collections.json
{"smart_collection":{"title":"Macbooks","rules":[{"column":"vendor","relation":"equals","condition":"Apple"}],"image":{"attachment":"R0lGODlhAQABAIAAAAAAAAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==\n","alt":"iPod"}}}
```

Response:
```
HTTP/1.1 201 Created
{"smart_collection":{"id":1063001324,"handle":"macbooks","title":"Macbooks","updated_at":"2025-01-02T11:37:05-05:00","body_html":null,"published_at":"2025-01-02T11:37:03-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/1063001324","image":{"created_at":"2025-01-02T11:37:05-05:00","alt":"iPod","width":1,"height":1,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1735835825"}}}
```
##### Create a new smart collection with an image that will be downloaded by Shopify
Request:
```
POST /admin/api/unstable/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"}}}
```

Response:
```
HTTP/1.1 201 Created
{"smart_collection":{"id":1063001332,"handle":"macbooks","title":"Macbooks","updated_at":"2025-01-02T11:37:39-05:00","body_html":null,"published_at":"2025-01-02T11:37:34-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/1063001332","image":{"created_at":"2025-01-02T11:37:36-05:00","alt":"Rails Logo","width":110,"height":140,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/collections/rails_logo20250102-63224-rhkl47.gif?v=1735835859"}}}
```
##### Create a new unpublished smart collection
Request:
```
POST /admin/api/unstable/smart_collections.json
{"smart_collection":{"title":"Macbooks","rules":[{"column":"vendor","relation":"equals","condition":"Apple"}],"published":false}}
```

Response:
```
HTTP/1.1 201 Created
{"smart_collection":{"id":1063001327,"handle":"macbooks","title":"Macbooks","updated_at":"2025-01-02T11:37:16-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/1063001327"}}
```
##### Create a smart collection of all products starting with the specified term
Request:
```
POST /admin/api/unstable/smart_collections.json
{"smart_collection":{"title":"IPods","rules":[{"column":"title","relation":"starts_with","condition":"iPod"}]}}
```

Response:
```
HTTP/1.1 201 Created
{"smart_collection":{"id":1063001336,"handle":"ipods-1","title":"IPods","updated_at":"2025-01-02T11:37:48-05:00","body_html":null,"published_at":"2025-01-02T11:37:48-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/1063001336"}}
```
##### Create a smart collection with a specified title
Request:
```
POST /admin/api/unstable/smart_collections.json
{"smart_collection":{"title":"Macbooks","rules":[{"column":"vendor","relation":"equals","condition":"Apple"}]}}
```

Response:
```
HTTP/1.1 201 Created
{"smart_collection":{"id":1063001330,"handle":"macbooks","title":"Macbooks","updated_at":"2025-01-02T11:37:24-05:00","body_html":null,"published_at":"2025-01-02T11:37:24-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/1063001330"}}
```
#### 422
Creates a smart collection

Examples:
##### Creating a smart collection without a title will return an error
Request:
```
POST /admin/api/unstable/smart_collections.json
{"smart_collection":{"body":"foobar","rules":[{"column":"vendor","relation":"equals","condition":"Apple"}]}}
```

Response:
```
HTTP/1.1 422 Unprocessable Entity
{"errors":{"title":["can't be blank"]}}
```
## Updates the ordering type of products in a smart collection

Updates the ordering type of products in a smart collection

### Endpoint
/admin/api/#{api_version}/smart_collections/{smart_collection_id}/order.json?products[]=921728736&products[]=632910392 (PUT)

### Parameters
* api_version (required): 
* smart_collection_id (required): 
* products: An array of product IDs, in the order that you want them to appear at the top of the collection. When <code>products</code> is specified but empty, any previously sorted products are cleared.
* sort_order: The type of sorting to apply. Valid values are listed in the <a href="#properties">Properties</a> section above.

### Responses
#### 200
Updates the ordering type of products in a smart collection

Examples:
##### Update manually-sorted products in the smart collection
Request:
```
PUT /admin/api/unstable/smart_collections/482865238/order.json
{}
```

Response:
```
HTTP/1.1 200 OK
{}
```
##### Update the type of ordering applied to the smart collection
Request:
```
PUT /admin/api/unstable/smart_collections/482865238/order.json
{}
```

Response:
```
HTTP/1.1 200 OK
{}
```