---
title: >-
  Shop metafield definitions are now available in the Shopify Admin and Admin
  API - 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/shop-metafield-now-in-admin'
  md: 'https://shopify.dev/changelog/posts/shop-metafield-now-in-admin.md'
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-05-21T16:40:12-04:00'
  postedAt: '2025-06-23T15:00:00-04:00'
  updatedAt: '2025-06-23T14:40:24-04:00'
  effectiveAt: '2025-05-23T12:00:00-04:00'
---

June 23, 2025

# Shop metafield definitions are now available in the Shopify Admin and Admin API

DateJune 23, 2025

Version[2025-07](https://shopify.dev/changelog?api_version=2025-07)

FlagsNew

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

Shop metafield definitions and values are now be exposed in the Shopify Admin UI, making them more accessible and manageable by merchants.

Additionally, it's now possible to query for shop metafield definitions using the [`metafieldDefinitions` query](https://shopify.dev/docs/api/admin-graphql/latest/queries/metafieldDefinitions) in the Admin GraphQL API.

Shop is already [a supported metafield owner type](https://shopify.dev/docs/api/admin-graphql/latest/enums/MetafieldOwnerType), and this change enables apps and merchants to manage definitions for shop-level metafields.