Metaobject analytics queryable capability available in the Admin API
Source: Shopify Dev Changelog
What Changed
Shopify has added a new capability to the GraphQL Admin API that allows developers to read and configure the analyticsQueryable field on metaobject definitions. This capability becomes available starting with API version 2027-01.
The MetaobjectCapabilities object now includes an analyticsQueryable field, which can be read to check whether a given metaobject definition is queryable in analytics. Apps that create, update, or inspect metaobject definitions can now programmatically set or check this capability as part of their definition configuration, alongside existing capabilities like translation support and publishing.
Why This Matters for Shopify App Developers
Metaobjects have become a core building block for custom data structures in Shopify apps, used for everything from product add-ons to custom content types. As merchants increasingly rely on metaobjects to store structured data, the ability to surface that data in Shopify’s analytics becomes more relevant for reporting and merchant-facing insights.
For apps that manage metaobject definitions programmatically, this update means you can now control whether the data types you create are discoverable in analytics queries, without requiring manual configuration by merchants in the Shopify admin.
Practical Implications
No immediate action is required for existing apps. The analyticsQueryable capability defaults to its current behavior unless explicitly configured otherwise.
Developers building or maintaining apps that define metaobject schemas should review their definition creation logic if they want explicit control over analytics visibility. This is particularly relevant for apps targeting merchants who rely on Shopify’s native analytics and reporting tools rather than third-party BI platforms.
Teams should update their GraphQL queries and mutations that interact with MetaobjectDefinition and MetaobjectCapabilities to account for this new field when upgrading to API version 2027-01 or later.