Shopify has introduced declarative custom data definitions, a new approach to managing metafields and metaobjects through TOML configuration files. Rather than manually defining custom data structures through the admin or API calls, developers can now organize these definitions in code and deploy them across multiple stores simultaneously using the improved app dev command. This shift from imperative to declarative management brings atomic updates, ensuring all connected stores maintain consistent definition versions automatically.
For Shopify app developers, this represents a significant quality-of-life improvement. Previously, migrating metafield and metaobject definitions across multiple merchant stores was time-consuming and error-prone, with no guarantee of consistency. The new approach eliminates these pain points by automating bulk distribution and guaranteeing atomic updates—meaning definitions either fully apply everywhere or nowhere, preventing partial rollouts and data inconsistencies. This is especially valuable for agencies and developers managing apps across dozens or hundreds of stores.
If your app requires OAuth authentication to manage these custom data definitions across client stores, GetShopifyToken provides secure token generation and management, streamlining the authentication layer so you can focus on implementing declarative definitions.