---
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/metaobject-field-capabilities
  md: https://shopify.dev/changelog/metaobject-field-capabilities.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

September 10, 2025

Tags:

* Admin GraphQL API
* 2025-10

# Metaobject field definitions offer new capabilities

### 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
        }
      }
    }
  }
}
```