You can now set specific permissions on API keys to control which data types each key can export or import, giving you better security and access control for integrations.
🚀 What’s New # API key permissions – limit export and import access on a per-data-type basis when creating or editing API keys. Granular access control – restrict keys to only the data types they need, like products-only or orders-only access.
When running an import, you can now see a preview of your results right on the job detail page, making it easier to verify that items were created or updated correctly.
🚀 What’s New # Import results preview – view up to 25 successful, failed, and skipped items per data type directly on the job detail page (learn more). Quick validation – click any result to open that item in Shopify Admin and verify the data. 🔧 Improvements # Import job pages now show only relevant sections for imports, reducing clutter. Error codes in results are now clickable links to documentation.
Importing zip codes that start with zeros (like 01234) can be tricky because Excel automatically strips leading zeros. We’ve made this easier to handle by allowing you to prefix the zip code with a single quote ('01234).
🔧 Improvements # Zip code formatting – prefix any zip code with a single quote ('01234) in your spreadsheet to preserve leading zeros. The quote is automatically removed during import and works for all address types across orders, draft orders, customers, and company locations.
We’ve improved how the ‘Category’ field matching works during product imports to be more flexible and reliable.
🔧 Improvements # Category matching – now performs case insensitive searches for better compatibility with various data formats. Google Shopping categories – automatically falls back to Google Shopping category names when Shopify taxonomy categories aren’t found.
We’ve added support for article_reference and list.article_reference metafields which Shopify introduced on September 23rd. This will make it easier to link articles in your metafield data.
🚀 What’s New # Article reference metafields – import and export article_reference and list.article_reference metafield types. Handle-based resolution – reference articles using their handles (blog.article_handle) for easier data management.
You can now manage your Shopify files from your terminal. Our new CLI lets you script uploads and downloads, making it easy to automate media management. To get started, go to the settings page of the app to generate an API key.
The CLI tool currently supports uploading and downloading files from Shopify Files. Soon we will add support for imports and exports.
Learn more about the tool in our CLI overview.
We’ve shipped updates that make order imports safer and order updates more predictable for busy teams.
🚀 What’s New # Address validation – detects incomplete billing/shipping addresses before sending data to Shopify Incomplete address error (ORD015) – clearer guidance when required address fields are only partially provided (see codes) Payment gateway safety – imported gateways are prefixed with manual to avoid triggering real charges (see reference)
We’ve improved menu imports to be safer and easier to troubleshoot.
🔧 Improvements # Circular reference detection – identifies loops in nested menu items and halts import with a clear message (read more) Better parent linking – prevents attaching a menu item to itself by title during import 🐛 Fixes # Consistent error code – surfaces MENU007 when a circular menu structure is detected (see docs)
Shopify no longer supports storing HS codes in the global.harmonized_system_code metafield. To keep imports working as expected, we now apply its value directly to variants.
🚀 What’s New # HS Code fallback – when we detect the global.harmonized_system_code metafield during import, we set the variant’s HS Code (on the InventoryItem) to that value (see docs). ⚠️ Heads-up # Metafield deprecation – Shopify no longer supports using global.harmonized_system_code to store HS codes. Use the Variant HS Code field instead.
Moving variant-linked data between stores is now simpler and more readable.
🔧 Improvements # Variant reference exports – now use [product handle].[variant title] for clearer spreadsheets and easier cross-store moves (Metafields reference). Variant reference imports – accept the same handle.title format; escape commas in variant titles with a backslash (e.g., Red \, Large) (Metafields reference). Lists supported – works for list.variant_reference columns as well.
