---
title: MetafieldStorefrontVisibility - GraphQL Admin
description: >-
  By default, the Storefront API can't read metafields. To make specific
  metafields visible in the Storefront API,

  you need to create a `MetafieldStorefrontVisibility` record. A
  `MetafieldStorefrontVisibility` record is a list

  of the metafields, defined by the `owner_type`, `namespace`, and `key`, to
  make visible in the Storefront API.


  Learn about [exposing metafields in the Storefront API]

  (https://shopify.dev/custom-storefronts/products-collections/metafields)

  for more details.
api_version: 2024-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MetafieldStorefrontVisibility
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MetafieldStorefrontVisibility.txt
---

# Metafield​Storefront​Visibility

object

By default, the Storefront API can't read metafields. To make specific metafields visible in the Storefront API, you need to create a `MetafieldStorefrontVisibility` record. A `MetafieldStorefrontVisibility` record is a list of the metafields, defined by the `owner_type`, `namespace`, and `key`, to make visible in the Storefront API.

Learn about \[exposing metafields in the Storefront API] (<https://shopify.dev/custom-storefronts/products-collections/metafields>) for more details.

## Fields

* created​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/DateTime)

  non-null

  The date and time when the metafield was set to visible in the Storefront API.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  non-null

  A globally-unique ID.

* key

  [String!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  non-null

  The key of a metafield to make visible in the Storefront API.

* legacy​Resource​Id

  [Unsigned​Int64!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/UnsignedInt64)

  non-null

  The ID of the corresponding resource in the REST Admin API.

* namespace

  [String!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  non-null

  The namespace of a metafield to make visible in the Storefront API.

* owner​Type

  [Metafield​Owner​Type!](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/MetafieldOwnerType)

  non-null

  The owner type of a metafield to make visible in the Storefront API.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/DateTime)

  non-null

  The date and time when the `MetafieldStorefrontVisibility` record was updated.

***

## Map

### Fields and connections with this object

* <->[MetafieldStorefrontVisibilityConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MetafieldStorefrontVisibilityConnection#field-nodes)
* {}[MetafieldStorefrontVisibilityEdge.node](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MetafieldStorefrontVisibilityEdge#field-node)

***

## Queries

### Deprecated queries

* [metafield​Storefront​Visibilities](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/metafieldStorefrontVisibilities)

  query

  Deprecated

* [metafield​Storefront​Visibility](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/metafieldStorefrontVisibility)

  query

  Deprecated

***

## \<?>MetafieldStorefrontVisibility Queries

***

## Mutations

* [metafield​Storefront​Visibility​Create](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/metafieldStorefrontVisibilityCreate)

  mutation

  Deprecated

***

## <\~> MetafieldStorefrontVisibility Mutations

***

## Interfaces

* * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/LegacyInteroperability)

    interface

  * [Node](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/Node)

    interface

***

## ||-MetafieldStorefrontVisibility Implements

### Implements

* ||-[Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/LegacyInteroperability)
* ||-[Node](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/Node)