---
title: >-
  Order metafield definitions and values can now be used as filters in the
  Shopify Admin UI - 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/order-metafield-definitions-and-values-can-now-be-used-as-filters-in-the-shopify-admin-ui
  md: >-
    https://shopify.dev/changelog/posts/order-metafield-definitions-and-values-can-now-be-used-as-filters-in-the-shopify-admin-ui.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-08-25T09:51:32-04:00'
  postedAt: '2025-09-16T11:30:00-04:00'
  updatedAt: '2025-09-16T11:33:39-04:00'
  effectiveAt: '2025-08-29T12:00:00-04:00'
---

September 16, 2025

# Order metafield definitions and values can now be used as filters in the Shopify Admin UI

DateSeptember 16, 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)

Order metafield definitions and values can now be used as filters in the Shopify Admin UI, enhancing the functionality of the order index. This update enables merchants and developers to efficiently manage and organize orders based on specific metafield criteria, streamlining order processing and improving operational efficiency.

Additionally, you can now query order metafield definitions through the Admin GraphQL API using the [`metafieldDefinitions` query](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/orders#argument-query-filter-metafields.%7Bnamespace%7D.%7Bkey%7D). This feature allows for more precise data retrieval and manipulation, giving developers greater control over order data.

Since orders are already [a supported metafield owner type](https://shopify.dev/docs/api/admin-graphql/latest/enums/MetafieldOwnerType), this change empowers apps and merchants to manage order-level metafield definitions more efficiently. By leveraging these enhancements, users can optimize their workflows and improve the overall management of order-related data.