---
title: >-
  Metaobject field definitions offer new capabilities - 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/metaobject-field-capabilities'
  md: 'https://shopify.dev/changelog/posts/metaobject-field-capabilities.md'
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-09-04T07:27:29-04:00'
  postedAt: '2025-09-10T10:00:00-04:00'
  updatedAt: '2025-09-04T16:50:54-04:00'
  effectiveAt: '2025-09-10T10:00:00-04:00'
---

September 10, 2025

# Metaobject field definitions offer new capabilities

DateSeptember 10, 2025

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

FlagsNew

SurfacesAPI

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

### What's new

As of `2025-10`, metaobject fields can now be made searchable and filterable in the Shopify admin through the new `admin_filterable` capability, bringing metaobject fields in line with the existing capability framework used by metafield definitions and enabling merchants to filter metaobject lists by field values and create saved views based on field criteria.

### Implementation

1. **Creating or updating field definitions**: When [creating](https://shopify.dev/docs/api/admin-graphql/latest/mutations/metaobjectDefinitionCreate) or [updating](https://shopify.dev/docs/api/admin-graphql/latest/mutations/metaobjectdefinitionupdate) metaobject field definitions through the Admin GraphQL API, you can now specify capabilities:

```graphql
mutation {
  metaobjectDefinitionCreate(definition: {
    name: "Product Metadata"
    type: "product_metadata"
    fieldDefinitions: [
      {
        key: "brand"
        name: "Brand"
        type: "single_line_text_field"
        capabilities: {
          adminFilterable: {
            enabled: true
          }
        }
      }
    ]
  }) {
    metaobjectDefinition {
      id
      fieldDefinitions {
        key
        capabilities {
          adminFilterable {
            enabled
          }
        }
      }
    }
  }
}
```

1. **Querying capability status**: When [querying metaobject fields](https://shopify.dev/docs/api/admin-graphql/latest/queries/metaobjectDefinition), check the status of the `admin_filterable` capability:

```graphql
query {
  metaobjectDefinition(id: "gid://shopify/MetaobjectDefinition/123") {
    fieldDefinitions {
      key
      name
      capabilities {
        adminFilterable {
          enabled
        }
      }
    }
  }
}
```