The collection object

Returns the total number of products in a collection, even when the collection is filtered.

For example, if a collection has 24 products in total, then the following input would lead to the following output:

Returns a list of all product tags in a collection, even when the collection is filtered. A maximum of 1,000 tags can be returned.

Returns a list of all product types in a collection.

For example, if a collection contained products of type Accessories, Chairs, and Shoes, then the following input would lead to the following output:

Returns a list of all product vendors in a collection.

For example, if a collection contained products from Shopify, Shirt Company, and Montezuma vendors, then the following input would lead to the following output:

You can query for products of a certain type at the /collections/types URL with a query parameter in the format of ?q=[type], where [type] is your desired product type. For example, the following URL would return products of type Shirts:

If you're on one of these pages, then collection.current_type returns the current type that's been queried. As such, you can check whether you're on one of these pages, and output the current type like the following:

You can query for products from a certain vendor at the /collections/vendors URL with a query parameter in the format of ?q=[vendor], where [vendor] is your desired product vendor. For example, the following URL would return products from the vendor ApparelCo:

If you're on one of these pages, then collection.current_vendor returns the current vendor that's been queried. As such, you can check whether you're on one of these pages, and output the current vendor like the following:

Returns the default sort order of the collection, which is set in the collection's page of the Shopify admin.

The possible sort orders are:

• manual
• best-selling
• title-ascending
• title-descending
• price-ascending
• price-descending
• created-ascending
• created-descending

Returns the description of the collection.

Returns the featured image for the collection. The default is the collection image, and then Shopify will fall back to an appropriate image, such as the featured image of the first product in the collection.

Returns an array of filter objects that have been set up on the collection.

Only filters relevant to the current collection are returned. Filters will be empty for collections that contain over 1000 products.

Returns the collection's handle.

Returns the ID number of the collection.

Returns the collection's image, which is set in the collection's page of the Shopify admin.

You can use the image_url URL filter, and add the image_tag HTML filter to to the image_url URL filter to output the image. You should also check whether the image exists before trying to output it.

For example:

Returns the collection's metafields.

Returns the product object of the next product in the collection, or nil if there is no next product.

For example, you can output a link to the next product in the collection:

Returns the product object of the previous product in the collection, or nil if there is no previous product.

For example, you can output a link to the previous product in the collection:

Returns an array of all the products in a collection.

You can use the paginate tag to choose how many products to show per page, up to a limit of 50.

Returns the number of products in a collection that match the current view.

For example, if you are viewing a collection filtered by a tag, and there are 6 products with that tag, then the following input would lead to the following output:

Returns the date and time when the collection was published.

You can use a date filter to format the date.

Returns the sort order applied to the collection by the sort_by URL parameter. If there is no sort_by URL parameter, then the value is nil.

For example, given the following URL, the following input would lead ot the following output:

Returns an array of sorting options for the collection.

For example, the following input would lead to the following output:

Each option has the following attributes:

• option.name
• option.value

The customer-facing label for the sort option, which can be edited by merchants in the language editor.

The value of the sort option to be assigned to the sort_by property in a form submission.

Returns the name of the custom collection template assigned to the collection, without the collection. prefix or the .liquid extension. Returns nil if a custom template is not assigned to the collection.

For example, if you had a collection template called collection.no-price.liquid, then the following input would lead to the following output:

Returns the title of the collection.

Returns the tags that are currently applied to a filtered collection, or nil.

Returns the URL of the collection.