New analyticsQueryable capability for Metafield Definitions

Shopify Adds Analytics Querying for Custom Metafields

Shopify has released a new analyticsQueryable capability for the MetafieldDefinition type in the GraphQL Admin API. This capability allows developers to designate specific metafields as queryable within Shopify Analytics, enabling merchants to filter and group analytics data using custom metafield values.

The capability is accessible through the MetafieldDefinition.capabilities field and can be configured when creating or updating metafield definitions through the Admin API. Once enabled, merchants can use these metafield values as dimensions in their analytics reports to segment performance data.

What This Means for App Developers

Apps that create custom metafields for products, variants, orders, or customers can now expose these fields for analytics purposes. This applies to apps managing product attributes, customer segmentation data, order tags, or any custom metadata that merchants might want to analyze alongside standard Shopify metrics.

Developers building analytics features or reporting tools can leverage this capability to provide merchants with more granular data analysis options without requiring separate data pipelines or custom reporting infrastructure.

Implementation Considerations

Apps will need to update their metafield definition creation logic to include the analyticsQueryable capability where appropriate. Not all metafields should be analytics-queryable—developers should consider data cardinality and whether the metafield contains values useful for grouping or filtering analytics data.

The feature works within Shopify’s existing Analytics infrastructure, meaning metafields marked as analytics-queryable will appear as available dimensions in the merchant’s analytics interface without additional configuration.

Read the full announcement →