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 or updating metaobject field definitions through the Admin GraphQL API, you can now specify capabilities:

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

2. Querying capability status: When querying metaobject fields, check the status of the admin_filterable capability:

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