---
title: >-
  New analyticsQueryable capability for Metafield Definitions - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/new-analyticsqueryable-capability-for-metafield-definitions
  md: >-
    https://shopify.dev/changelog/posts/new-analyticsqueryable-capability-for-metafield-definitions.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-03-03T19:08:01-05:00'
  postedAt: '2026-03-05T12:00:00-05:00'
  updatedAt: '2026-03-04T10:50:46-05:00'
  effectiveAt: '2026-03-05T12:00:00-05:00'
---

March 5, 2026

# New analyticsQueryable capability for Metafield Definitions

DateMarch 5, 2026

Version[2026-04](https://shopify.dev/changelog?api_version=2026-04)

FlagsNew

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

The `analyticsQueryable` capability is now available on the `MetafieldDefinition` type in the GraphQL Admin API, enabling you to specify whether a metafield can be queried in Shopify Analytics. This enhancement allows merchants to leverage custom metafield values for filtering and grouping data, providing deeper insights into their store's performance.

You can access this capability via the `MetafieldDefinition.capabilities` field. It can be set during the creation or update of a metafield definition using the `metafieldDefinitionCreate` and `metafieldDefinitionUpdate` mutations.

Once enabled, the metafield becomes a dimension and filter in ShopifyQL and Shopify's Analytics, empowering merchants to refine their data analysis. Currently, this functionality supports the following `MetafieldDefinition.ownerType` values:

* `PRODUCT`
* `PRODUCTVARIANT`
* `ORDER`
* `CUSTOMER`

**Example: Enabling Analytics Queryable on a New Metafield Definition**

The following GraphQL mutation demonstrates how to enable the `analyticsQueryable` capability for a new metafield definition. This example sets up a metafield for products, allowing it to be used in analytics queries:

```graphql
mutation {
  metafieldDefinitionCreate(definition: {
    name: "Fabric"
    namespace: "custom"
    key: "fabric"
    type: "single_line_text_field"
    ownerType: PRODUCT
    capabilities: {
      analyticsQueryable: { enabled: true }
    }
  }) {
    createdDefinition {
      id
      capabilities {
        analyticsQueryable {
          enabled
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}
```

This mutation creates a new metafield definition with the `analyticsQueryable` capability enabled, making it available for use in Shopify Analytics.