Metaobject analytics queryable capability available in the Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on October 20, 2026.
This Shopify update is categorized as API, New, GraphQL Admin API, 2027-01.
What changed
The GraphQL Admin API now exposes the analytics queryable capability for metaobject definitions. You can read MetaobjectCapabilities.analyticsQueryable, which includes: eligible: whether the metaobject definition can use the capability. A definition is eligible if at least one of its fields uses an analytics-compatible type. enabled: whether the capability is currently enabled. You can also set the capability when you create or update a metaobject definition by using: MetaobjectCapabilityCreateInput.analyticsQueryable MetaobjectCapabilityUpdateInput.analyticsQueryable MetaobjectCapabilityAnalyticsQueryableInput.enabled The MetaobjectCapabilityType enum now includes ANALYTICS_QUERYABLE, and MetaobjectUserErrorCode includes CAPABILITY_NOT_ELIGIBLE for definitions that can’t enable the capability.
Who is affected
This change applies to apps that use GraphQL Admin API version 2027-01 or later to create, update, or inspect metaobject definitions. Apps that use earlier versions don’t see the analyticsQueryable field, input, enum value, or error code. Existing apps don’t need to make changes unless they want to support analytics queryability for metaobject definitions.
What action may be needed
No action is required. If you want to use this capability: Update your app to use GraphQL Admin API version 2027-01 or later. Update your metaobject definition queries or mutations to include analyticsQueryable. For example, to read a metaobject definition’s capabilities, include: capabilities { analyticsQueryable { eligible enabled } } When you create or update a metaobject definition, set analyticsQueryable.enabled in the capability input.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →