← All Shopify Updates
Shopify Update · Published April 21, 2026 · Source: Migrate metafields with `shopify app import-custom-data-definitions`

Shopify CLI 3.89 Introduces Metafield Migration Command in 2026

What Changed

Shopify has released a new command in CLI version 3.89 called shopify app import-custom-data-definitions, which automates the migration of metafield and metaobject definitions to declarative TOML management. This command scans all app-owned definitions on your dev store—including those with $app namespaces and metaobjects with $app:example type patterns—and automatically converts them into TOML format that can be added to your shopify.app.toml file.

Why This Matters

Previously, managing metafield definitions required manual configuration or API calls, making it time-consuming to maintain consistency across environments. This new command significantly reduces friction by automating the conversion process and enabling version-controlled, declarative management of your app's data schema. For developers building Shopify apps, this means faster deployment cycles, easier collaboration, and improved reliability when syncing definitions across development, staging, and production stores.

What You Should Do

How GetShopifyToken Helps

GetShopifyToken simplifies the authentication process required to run CLI commands against your Shopify store. By handling OAuth securely, we make it easier to obtain and manage the access tokens your CLI needs to execute metafield migrations and other administrative tasks without manual token management.

← More Shopify Updates