---
title: "Liquid objects: collection"
description: A [collection](https://help.shopify.com/manual/products/collections) in a store.
api_name: liquid
source_url:
html: https://shopify.dev/docs/api/liquid/objects/collection
md: https://shopify.dev/docs/api/liquid/objects/collection.md
---
# collection
A [collection](https://help.shopify.com/manual/products/collections) in a store.
## Properties
* * all\_products\_count
[number](https://shopify.dev/docs/api/liquid/basics#number)
* The total number of products in a collection.
This includes products that have been filtered out of the current view.
Tip
To display the number of products in a filtered collection, use [`collection.products_count`](https://shopify.dev/docs/api/liquid/objects/collection#collection-products_count).
* all\_tags
array of [string](https://shopify.dev/docs/api/liquid/basics#string)
* All of the tags applied to the products in the collection.
This includes tags for products that have been filtered out of the current view. A maximum of 1,000 tags can be returned.
Tip
To display the tags that are currently applied, use [`collection.tags`](https://shopify.dev/docs/api/liquid/objects/collection#collection-tags).
* all\_types
array of [string](https://shopify.dev/docs/api/liquid/basics#string)
* All of the product types in a collection.
ExampleCreate links to product types
Use the [`link_to_type`](https://shopify.dev/docs/api/liquid/filters/link_to_type) filter to create links to the product types in a collection.
```liquid
{% for product_type in collection.all_types -%}
{{- product_type | link_to_type }}
{%- endfor %}
```
## Output
```html
Animals & Pet SuppliesBaking Flavors & ExtractsCooking & Baking IngredientsDried FlowersFruits & VegetablesSeasonings & SpicesWater
```
* all\_vendors
array of [string](https://shopify.dev/docs/api/liquid/basics#string)
* All of the product vendors in a collection.
ExampleCreate links to vendors
Use the [`link_to_vendor`](https://shopify.dev/docs/api/liquid/filters/link_to_vendor) filter to create links to the vendors in a collection.
```liquid
{% for product_vendor in collection.all_vendors %}
{{- product_vendor | link_to_vendor }}
{% endfor %}
```
## Output
```html
Clover's ApothecaryPolina's Potent PotionsTed's Apothecary Supply
```
* current\_type
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The product type on a product type collection page.
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.
Tip
The query value is case-insensitive, so `shirts` is equivalent to `Shirts` or `SHIRTS`.
* current\_vendor
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The vendor name on a vendor collection page.
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.
Tip
The query value is case-insensitive, so `apparelco` is equivalent to `ApparelCo` or `APPARELCO`.
* default\_sort\_by
[string](https://shopify.dev/docs/api/liquid/basics#string) from a set of values
* The default sort order of the collection.
This is set on the collection's page in the Shopify admin.
| Possible values |
| - |
| manual |
| best-selling |
| title-ascending |
| price-ascending |
| price-descending |
| created-ascending |
| created-descending |
* description
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The description of the collection.
* featured\_image
[image](https://shopify.dev/docs/api/liquid/objects/image)
* The featured image for the collection.
The default is the [collection image](https://shopify.dev/docs/api/liquid/objects/collection#collection-image). If this image isn't available, then Shopify falls back to the featured image of the first product in the collection. If the first product in the collection doesn't have a featured image, then `nil` is returned.
* filters
array of [filter](https://shopify.dev/docs/api/liquid/objects/filter)
* The [storefront filters](https://help.shopify.com/manual/online-store/themes/customizing-themes/storefront-filters) 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 5000 products.
To learn about supporting filters in your theme, refer to [Support storefront filtering](https://shopify.dev/themes/navigation-search/filtering/storefront-filtering/support-storefront-filtering).
* handle
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The [handle](https://shopify.dev/docs/api/liquid/basics#handles) of the collection.
* id
[number](https://shopify.dev/docs/api/liquid/basics#number)
* The ID of the collection.
* image
[image](https://shopify.dev/docs/api/liquid/objects/image)
* The image for the collection.
This image is added on the collection's page in the Shopify admin.
* metafields
array of [metafield](https://shopify.dev/docs/api/liquid/objects/metafield)
* The [metafields](https://shopify.dev/docs/api/liquid/objects/metafield) applied to the collection.
Tip
To learn about how to create metafields, refer to [Create and manage metafields](https://shopify.dev/apps/metafields/manage) or visit the [Shopify Help Center](https://help.shopify.com/manual/metafields).
* next\_product
[product](https://shopify.dev/docs/api/liquid/objects/product)
* The next product in the collection. Returns `nil` if there's no next product.
This property can be used on the [product page](https://shopify.dev/themes/architecture/templates/product) to output `next` links.
* previous\_product
[product](https://shopify.dev/docs/api/liquid/objects/product)
* The previous product in the collection. Returns `nil` if there's no previous product.
This property can be used on the [product page](https://shopify.dev/themes/architecture/templates/product) to output `previous` links.
* products
array of [product](https://shopify.dev/docs/api/liquid/objects/product)
* All of the products in the collection.
Tip
Use the [paginate](https://shopify.dev/docs/api/liquid/tags/paginate) tag to choose how many products to show per page, up to a limit of 50.
* products\_count
[number](https://shopify.dev/docs/api/liquid/basics#number)
* The total number of products in the current view of the collection.
* published\_at
[string](https://shopify.dev/docs/api/liquid/basics#string)
* A timestamp for when the collection was published.
Tip
Use the [`date` filter](https://shopify.dev/docs/api/liquid/filters/date) to format the timestamp.
* sort\_by
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The sort order applied to the collection by the `sort_by` URL parameter.
If there's no `sort_by` URL parameter, then the value is `nil`.
* sort\_options
array of [sort\_option](https://shopify.dev/docs/api/liquid/objects/sort_option)
* The available sorting options for the collection.
ExampleOutput the sort options
```liquid
{%- assign sort_by = collection.sort_by | default: collection.default_sort_by -%}
```
## Output
```html
```
* tags
array of [string](https://shopify.dev/docs/api/liquid/basics#string)
* The tags that are currently applied to the collection.
This doesn't include tags for products that have been filtered out of the current view. Returns `nil` if no tags have been applied, or all products with tags have been filtered out of the current view.
* template\_suffix
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The name of the [custom template](https://shopify.dev/themes/architecture/templates#alternate-templates) assigned to the collection.
The name doesn't include the `collection.` prefix, or the file extension (`.json` or `.liquid`).
If a custom template isn't assigned to the collection, then `nil` is returned.
* title
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The title of the collection.
* url
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The relative URL of the collection.
```json
{
"all_products_count": 10,
"all_tags": [
"Burning",
"dried",
"extracts",
"fresh",
"ingredients",
"plant",
"supplies"
],
"all_types": [
"Animals & Pet Supplies",
"Baking Flavors & Extracts",
"Cooking & Baking Ingredients",
"Dried Flowers",
"Fruits & Vegetables",
"Seasonings & Spices",
"Water"
],
"all_vendors": [
"Clover's Apothecary",
"Polina's Potent Potions",
"Ted's Apothecary Supply"
],
"current_type": null,
"current_vendor": null,
"default_sort_by": "created-ascending",
"description": "Brew your own potions at home using our fresh, ethically-sourced ingredients.",
"featured_image": {},
"filters": {},
"handle": "ingredients",
"id": 266168401985,
"image": {},
"metafields": {},
"next_product": null,
"previous_product": null,
"products": {},
"products_count": 1,
"published_at": "2022-04-19 09:52:18 -0400",
"sort_by": "",
"sort_options": [],
"tags": [
"Burning"
],
"template_suffix": "eight-products-per-page",
"title": "Ingredients",
"url": {}
}
```
## Templates using collection
[](https://shopify.dev/themes/architecture/templates/collection)
[Theme architecturecollection template](https://shopify.dev/themes/architecture/templates/collection)