What’s New in Metaobject Field Definitions
Starting October 2025, Shopify introduces enhanced capabilities for metaobject fields. Merchants can now make these fields searchable and filterable directly in the Shopify admin. This new feature—admin_filterable capability—aligns metaobject fields with the established capability framework used by metafield definitions. These improvements empower merchants to filter metaobject lists by field values and create saved views based on specific criteria.
Key Benefits of Admin_Filterable Capability
- Boosts merchant efficiency by allowing field-based filtering within the Shopify admin.
- Enables merchants to save custom views using their field criteria.
- Offers flexibility and alignment with metafield capabilities for better usability.
How to Implement Field Definitions
Creating or Updating Field Definitions
To leverage these new capabilities, you can specify them when creating or updating metaobject field definitions using the Admin GraphQL API. An example mutation is provided below:
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 } } } } } }Querying Capability Status
You can also query the status of the admin_filterable capability for metaobject fields using the example below:
query { metaobjectDefinition(id: "gid://shopify/MetaobjectDefinition/123") { fieldDefinitions { key name capabilities { adminFilterable { enabled } } } } }Why These Changes Matter
- Enable merchants to better organize and manage data in their Shopify store.
- Enhance usability and operational efficiency within the admin panel.
- Provide deeper customization options and improved field-based filtering.