Shopify

• Shopify for Craft now supports version 2025-07 of Shopify’s GraphQL Admin API.
• Fixed a PHP error that could occur with missing environment variables. (#178)

• Fixed a bug where Shopify data could be overwritten when syncing products. (#177)

• Fixed a PHP error that could occur when upgrading. (#176)

• Fixed a PHP error that occurred when setting the Shopify host name to a non myshopify domain. (#168)
• Fixed a PHP error that occurred when creating product drafts. (#176)

• Fixed a SQL error that occurred when syncing products on MariaDB. (#166)
• Fixed a SQL error that could occur when upgrading.

• Fixed a bug where image sort order wasn’t being respected when syncing products. (#161)

• Fixed a PHP error that could occur when viewing Shopify utilities. (#156)
• Fixed a bug where image was missing from Shopify variant data.

After updating, go to Shopify → Webhooks and create the missing webhooks.

• Shopify for Craft now uses the GraphQL Admin API to interact with Shopify.
• Shopify now requires Craft CMS 4.15.0+ or 5.0.0+.
• Data syncing is now done via the queue.
• Added the shopify/data/reset command.
• Added craft\shopify\Plugin::getBulkOperation().
• Added craft\shopify\api\BulkDataBatcher.
• Added craft\shopify\console\controllers\DataController.
• Added craft\shopify\controllers\Sync.
• Added craft\shopify\db\ProductQuery::$publishedOnCurrentPublication.
• Added craft\shopify\db\ProductQuery::$shopifyGid.
• Added craft\shopify\db\ProductQuery::$withAll.
• Added craft\shopify\db\ProductQuery::$withImages.
• Added craft\shopify\db\ProductQuery::$withMetafields.
• Added craft\shopify\db\ProductQuery::$withVariants.
• Added craft\shopify\db\ProductQuery::publishedOnCurrentPublication().
• Added craft\shopify\db\ProductQuery::shopifyGid().
• Added craft\shopify\db\ProductQuery::withAll().
• Added craft\shopify\db\ProductQuery::withImages().
• Added craft\shopify\db\ProductQuery::withMetafields().
• Added craft\shopify\db\ProductQuery::withVariants().
• Added craft\shopify\db\Table::DATA.
• Added craft\shopify\elements\Product::$publishedOnCurrentPublication.
• Added craft\shopify\elements\Product::$shopifyGid.
• Added craft\shopify\elements\Product::getData().
• Added craft\shopify\elements\Product::getDescriptionHtml().
• Added craft\shopify\elements\Product::setData().
• Added craft\shopify\elements\Product::setDescriptionHtml().
• Added craft\shopify\helpers\Product::shopifyPublishedHtml().
• Added craft\shopify\helpers\Product::shopifyStatusHtml().
• Added craft\shopify\jobs\ProcessBulkOperationData.
• Added craft\shopify\models\BulkOperation.
• Added craft\shopify\records\BulkOperation.
• Added craft\shopify\records\ShopifyData.
• Added craft\shopify\services\Api::WEBHOOK_TOPICS.
• Added craft\shopify\services\Api::createQuery().
• Added craft\shopify\services\Api::deleteWebhookById().
• Added craft\shopify\services\Api::getGqlClient().
• Added craft\shopify\services\Api::getProductGql().
• Added craft\shopify\services\Api::getShop().
• Added craft\shopify\services\Api::getShopGql().
• Added craft\shopify\services\Api::getShopifyDataByType().
• Added craft\shopify\services\Api::getWebhooks().
• Added craft\shopify\services\Api::query().
• Added craft\shopify\services\BulkOperations.
• Added craft\shopify\services\Products::deleteShopifyDataByShopifyId().
• Added craft\shopify\services\Products::eagerLoadImagesForProducts().
• Added craft\shopify\services\Products::eagerLoadMetafieldsForProducts().
• Added craft\shopify\services\Products::eagerLoadVariantsForProducts().
• Added craft\shopify\services\Products::normalizeShopifyGid().
• craft\shopify\events\ShopifyProductSyncEvent::$source now has a type of array.
• craft\shopify\services\Products::createOrUpdateProduct() no longer has $metafields and $variants arguments.
• craft\shopify\services\Products::createOrUpdateProduct()’s $product argument now has a type of array.
• Renamed craft\shopify\handlers\Product to Webhook.
• Deprecated craft\shopify\elements\Product::getBodyHtml(). getDescriptionHtml() should be used instead.
• Deprecated craft\shopify\elements\Product::getShopifyStatusHtml(). craft\shopify\helpers\Product::shopifyStatusHtml() should be used instead.
• Deprecated craft\shopify\elements\Product::setBodyHtml(). setDescriptionHtml() should be used instead.
• Deprecated craft\shopify\helpers\Metafields.
• Deprecated craft\shopify\models\Settings::$syncProductMetafields. Metafields are always included when synchronizing product data.
• Deprecated craft\shopify\models\Settings::$syncVariantMetafields. Metafields are always included when synchronizing variant data.
• Deprecated craft\shopify\services\Api::get(). query() should be used instead.
• Deprecated craft\shopify\services\Api::getAll(). query() should be used instead.
• Deprecated craft\shopify\services\Api::getAllProducts().
• Deprecated craft\shopify\services\Api::getClient(). getGqlClient() should be used instead.
• Deprecated craft\shopify\services\Api::getMetafieldsByIdAndOwnerResource().
• Deprecated craft\shopify\services\Api::getMetafieldsByProductId().
• Deprecated craft\shopify\services\Api::getMetafieldsByVariantId().
• Deprecated craft\shopify\services\Api::getProductByShopifyId().
• Deprecated craft\shopify\services\Api::getProductIdByInventoryItemId().
• Deprecated craft\shopify\services\Api::getVariantsByProductId().
• Removed craft\shopify\db\Table::PRODUCTDATA.
• Removed craft\shopify\elements\Product::$publishedScope.
• Removed craft\shopify\elements\db\ProductQuery::$publishedScope.
• Removed craft\shopify\elements\db\ProductQuery::publishedScope().
• Removed craft\shopify\jobs\UpdateProductMetadata.
• Removed craft\shopify\records\ProductData.
• Removed craft\shopify\services\Api::SHOPIFY_API_VERSION.
• Removed craft\shopify\services\Products::$sleepSeconds.
• Removed craft\shopify\services\Products::$throttle.

• Fixed a PHP error that could occur when updating. (#133)

• It is now possible to associate Shopify products with elements imported in Feed Me. (#116)
• Added craft\shopify\feedme\fields\Products.

• Fixed a PHP error that could occur when trying to create webhooks. (#129)

• Shopify now requires Craft CMS 4.3.0+ or 5.0.0+.
• Added the “API Version” setting. (#128, #121)
• Added support for selecting products in Link fields. (Craft 5 only.)
• Product syncing now uses presentment prices by default. (#122)
• Added craft\shopify\linktypes\Product.
• Added craft\shopify\models\Settings::getApiVersion().
• Added craft\shopify\models\Settings::setApiVersion().
• Added craft\shopify\services\Api::getMetaFieldClass().
• Added craft\shopify\services\Api::getProductClass().
• Added craft\shopify\services\Api::getSupportedApiVersions().
• Added craft\shopify\services\Api::getVariantClass().
• Deprecated craft\shopify\services\Api::SHOPIFY_API_VERSION.
• Fixed a bug where variant column data could be larger than a MySQL TEXT column.

• shopify/sync commands now support a --throttle option.
• Fixed a bug where syncing Shopify variants would be limited to 50. (#115)
• Added craft\shopify\console\controllers\SyncController::$throttle.
• Added craft\shopify\services\Products::$throttle.
• Added craft\shopify\services\Products::$sleepSeconds.

• Fixed a bug where syncing meta fields would cause Shopify API rate limiting.
• Fixed a bug where variant meta fields weren’t being unpacked.

• Fixed a PHP error that could occur when syncing products with emojis. (#107)
• Fixed a PHP error that could occur when syncing products. (#105)

• Added support for syncing variant meta fields. (#99)
• Added the syncProductMetafields and syncVariantMetafields config settings, which can be enabled to sync meta fields.
• Added craft\shopify\models\Settings::$syncProductMetafields.
• Added craft\shopify\models\Settings::$syncVariantMetafields.

• Shopify now requires Craft CMS 5.0.0-beta.10 or later.

• Fixed a PHP error that could occur when syncing products with emojis. (#107)
• Fixed a PHP error that could occur when syncing products. (#105)

• Fixed a bug where syncing meta fields would cause Shopify API rate limiting.
• Fixed a bug where variant meta fields weren’t being unpacked.

• Added support for syncing variant meta fields. (#99)
• Added the syncProductMetafields and syncVariantMetafields config settings, which can be enabled to sync meta fields.
• Added craft\shopify\models\Settings::$syncProductMetafields.
• Added craft\shopify\models\Settings::$syncVariantMetafields.

After updating, visit your Shopify store and go to Settings → Apps and sales channels → Develop apps → [your app] → Configuration, and update the Webhook version setting to 2023-10.

• Syncing meta fields is no longer performed via a queue job.
• Shopify products’ reference handle is now shopifyproduct. (#77)
• Deprecated craft\shopify\jobs\UpdateProductMetadata.
• Removed craft\shopify\events\ShopifyProductSyncEvent::$metafields. ShopifyProductSyncEvent::$element->getMetaFields() can be used instead.
• shopify/shopify-api 5.2.0 or later is now required. (#81, #84)
• Fixed a bug where routes weren’t saving the chosen template.

• Added support for syncing variant inventory levels. (#61)
• Added craft\shopify\elements\db\ProductQuery::publishedScope(). (#65)
• Fixed a PHP error that occurred when saving the plugin settings in headless mode. (#68)
• Fixed a bug where changes to the product field layout in the project config weren’t applying correctly. (#52)
• Fixed an error that occurred when installing the plugin on PostgreSQL. (#58)

• Fixed a SQL error that occurred when syncing products with several tags. (#54)
• Product metadata is now synced via a queue job to avoid the Shopify API rate limiting.

• Added the resave/shopify-products console command. (#47)
• Products are now automatically re-saved when the “Product URI Format” setting is changed. (#47)
• The product field layout is now stored in the project config.

• Fixed a PHP error that occurred when saving invalid settings. (#39, #40)
• Added craft\shopify\elements\Product::getCheapestVariant().
• Added craft\shopify\elements\Product::getDefaultVariant().

• Fixed a namespacing bug.

• Initial release under new management. If you’re upgrading from Shopify Product Fetcher, see Migrating from v2.x.