Each task is configured with a specific Shopify API version, defaulting to the latest version at the time of the task's creation.
This version is used in all activity related to the current task, including:
REST API calls performed to support Liquid lookups
GraphQL calls performed by the shopify Liquid filter
All Shopify API versions are named with a specific date (i.e. "2021-07"), except for "unstable". This version receives regular updates from Shopify, and its features may change without notice.
Most tasks should use a dated version, to maximize the amount of time a task can rely on a specific set of Shopify API features.
Shopify supports each version for 12 months (except for "unstable", which is always available). 30 days before a task's version becomes unsupported, Mechanic will automatically begin calling the closest supported version instead.
Shopify may, at times, mark certain API features as deprecated. If a Mechanic account calls a deprecated API, Mechanic will display the deprecation notice in the app. Learn more about Shopify API deprecations.
The selector for a task's Shopify API version is available towards the end of the task's advanced settings.