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

2. Querying capability status: When querying metaobject fields, check the status of the admin_filterable capability: graphql query { metaobjectDefinition(id: "gid://shopify/MetaobjectDefinition/123") { fieldDefinitions { key name capabilities { adminFilterable { enabled } } } } }