SmartCollections

Columns

Name

Type

ReadOnly

Description

Id [KEY]

Long

True

The ID of the smart collection.

Title

String

False

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

BodyHtml

String

False

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

Image

String

False

A JSON aggregate with information regarding the image of smart collection.

Rules

String

False

A JSON aggregate with the list of rules that define what products go into the 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

Handle

String

False

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)

Disjunctive

Boolean

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.

SortOrder

String

False

The order in which products in the smart collection appear.

TemplateSuffix

String

False

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.

PublishedScope

String

False

Whether the smart collection is published to Point of Sale. Valid values: web: The smart collection is published to the shop's online channels and not published to the Point of Sale channel, global: The smart collection is published to both the online channels and the Point of Sale channel.

UpdatedAt

Datetime

True

The date and time when the smart collection was last modified.

PublishedAt

Datetime

True

The date and time when the smart collection was published. Returns null when the collection is hidden.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name

Type

Description

ProductId

String

Show smart collections that include a given product.

PublishedStatus

String

Show smart collection with a given published status: published: show only published smart collections, unpublished: show only unpublished smart collections, any: show all smart collections. (default: any).

Last updated