---
title: >-
  Removing visible_to_storefront_api field on metaobject field definitions -
  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/removing-storefront-visibility-field-on-metaobject-field-definitions
  md: >-
    https://shopify.dev/changelog/removing-storefront-visibility-field-on-metaobject-field-definitions.md
metadata:
  effectiveApiVersion: 2026-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2025-09-29T18:02:54-04:00'
  postedAt: '2026-03-30T12:00:00-04:00'
  updatedAt: '2026-03-31T17:07:43-04:00'
  effectiveAt: '2025-09-30T12:00:00-04:00'
---

March 30, 2026

Tags:

* Action Required
* Admin GraphQL API
* 2026-07

# Removing `visible_to_storefront_api` field on metaobject field definitions

## What's changing

The `visibleToStorefrontApi` field/input field is deprecated and removed from the `unstable` version of the GraphQL Admin API for the following types:

* [`MetaobjectFieldDefinition`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectFieldDefinition)
* [`MetaobjectFieldDefinitionCreateInput`](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/MetaobjectFieldDefinitionCreateInput)
* [`MetaobjectFieldDefinitionUpdateInput`](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/MetaobjectFieldDefinitionUpdateInput)
* [`StandardMetaobjectDefinitionFieldTemplate`](https://shopify.dev/docs/api/admin-graphql/latest/objects/StandardMetaobjectDefinitionFieldTemplate)

## Who's affected

* Anyone using `visibleToStorefrontApi` field or input field on a Metaobject field definition

**NOTE**: With the exception of `StandardMetaobjectDefinitionFieldTemplate`, this field was only ever exposed in `unstable`.

## Why we're making this change

This field implies a system behaviour that doesn't exist. It isn't possible to toggle the storefront visibility of individual fields. The only storefront visibility controls are on the `access` fields of the metaobject definition itself.

## Action required

If your app has a query or mutation that's referencing the `visibleToStorefrontApi` field on a Metaobject field definition, you need to remove that field.

## Key dates

**April 2, 2026**: `visibleToStorefrontApi` field on metaobject field definitions will be removed from `unstable` and `2026-07`