# Collection object

{% hint style="danger" %}
**Important Notice**

\
Shopify has deprecated the REST Admin API that these Mechanic objects depend on. The product and variant endpoints were removed on Feb 1, 2025, and Shopify is phasing out the remaining REST endpoints over time. Read about the deprecation [here](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model#whats-changing) and [here](https://shopify.dev/docs/apps/build/graphql/migrate).\
\
Use the [GraphQL](https://learn.mechanic.dev/core/actions/shopify#graphql) going forward. The [product](https://learn.mechanic.dev/platform/liquid/objects/shopify/product) and [variant](https://learn.mechanic.dev/platform/liquid/objects/shopify/variant) objects ceased to work on Feb 1, 2025 due to changes made by Shopify. Shopify is phasing out the REST API entirely — read more [here](https://shopify.dev/docs/apps/build/graphql/migrate).

\
All of our [library tasks](https://tasks.mechanic.dev/) will be ported to use GraphQL only, which will provide a model for how you can update your custom tasks. You'll be able to update your non-customized library tasks with a click of a button :relaxed:\
\
Please see these [guides](https://learn.mechanic.dev/resources/converting-tasks-from-shopify-rest-to-graphql) for migrating your custom tasks to GraphQL.
{% endhint %}

## How to access it

* Use `{{ collection }}` in tasks responding to shopify/collections events
* Look up specific collections by their ID, using `{{ shop.collections[1234567890] }}`
* Locate it in the array of product collections, using `{{ products.collections[0] }}`, in tasks responding to shopify/products events

## What it contains

* Every property from the Collection resource in the Shopify REST Admin API — see documentation for [custom collections](https://shopify.dev/docs/admin-api/rest/reference/products/customcollection), and for [automatic/smart collections](https://shopify.dev/docs/admin-api/rest/reference/products/smartcollection)
* An array of related [product objects](https://learn.mechanic.dev/platform/liquid/objects/shopify/product), ordered by their position in the collection: `{{ collection.products }}`