---
title: >-
  Breaking change to metafieldDefinitionUpdate mutation: access input type
  changed - 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/breaking-change-to-metafielddefinitionupdate-mutation-access-input-type-changed
  md: >-
    https://shopify.dev/changelog/breaking-change-to-metafielddefinitionupdate-mutation-access-input-type-changed.md
metadata:
  effectiveApiVersion: 2023-10
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2023-09-12T16:28:44-04:00'
  postedAt: '2023-10-01T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:39-05:00'
  effectiveAt: '2023-10-01T00:00:00-04:00'
---

October 1, 2023

Tags:

* Action Required
* API
* 2023-10

# Breaking change to metafieldDefinitionUpdate mutation: access input type changed

**Note:** This change does not affect many apps and you likely aren't affected unless you are defining a variable of type `MetafieldAccessInput` for the access property in your `MetafieldDefinitionUpdate` mutation.

As of GraphQL Admin API version 2023-10, we are changing the input field type of `MetafieldDefinitionUpdateInput.access` from `MetafieldAccessInput` to `MetafieldAccessUpdateInput`. This change is part of a broader API change to introduce support for explicit access grants (see [Introducing explicit access grants for app-owned metafields](https://shopify.dev/changelog/introducing-explicit-access-grants-for-app-owned-metafields) for details), which will have a different input for updating the grants on existing definitions than for specifying grants on new definitions.