Enable the analytics queryable capability on metafield and metaobject definitions from your app's TOML
Source: Shopify Dev Changelog
What Changed
Shopify now allows developers to enable the analytics_queryable capability on metafield and metaobject definitions directly from an app’s shopify.app.toml file. This capability was previously configurable only through the GraphQL Admin API, requiring a separate mutation call after defining the metafield or metaobject.
With this update, developers can add capabilities.analytics_queryable = true to their declarative definitions in the TOML configuration. When set to true, the values stored in that metafield or metaobject become available as dimensions and filters within Shopify Analytics and ShopifyQL, Shopify’s query language for analytics data.
Why This Matters for Shopify App Developers
Declarative app configuration in shopify.app.toml is central to how Shopify CLI manages app setup, versioning, and deployment. Previously, enabling analytics queryability required an extra API call outside this declarative flow, creating a disconnect between the app’s configuration source of truth and its runtime behavior.
By moving this capability into the TOML file, developers can manage the entire lifecycle of a metafield or metaobject definition, including its analytics behavior, in one place. This reduces setup steps, simplifies version control for app configuration, and aligns with Shopify’s broader push toward config-as-code for app development.
Practical Implications
Developers building apps that rely on custom data structures, such as product attributes, order metadata, or custom content models, should review their existing metafield and metaobject definitions. Adding analytics_queryable = true where relevant allows merchants to build custom reports using that data without additional backend work.
Teams currently setting this capability via GraphQL mutations can migrate that logic into their TOML files to simplify deployment pipelines. Developers should consult the updated metafield and metaobject definition schema in Shopify’s app configuration reference to confirm correct syntax placement within nested capability blocks.