---
title: Metaobject - Storefront API
description: An instance of a user-defined model based on a MetaobjectDefinition.
api_version: 2025-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/metaobject
  md: https://shopify.dev/docs/api/storefront/latest/objects/metaobject.md
---

# Metaobject

object

Requires `unauthenticated_read_metaobjects` access scope.

An instance of a user-defined model based on a MetaobjectDefinition.

## Fields

* field

  [Metaobject​Field](https://shopify.dev/docs/api/storefront/latest/objects/MetaobjectField)

  Token access required

  Accesses a field of the object by key.

* fields

  [\[Metaobject​Field!\]!](https://shopify.dev/docs/api/storefront/latest/objects/MetaobjectField)

  non-null Token access required

  All object fields with defined values. Omitted object keys can be assumed null, and no guarantees are made about field order.

* handle

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null Token access required

  The unique handle of the metaobject. Useful as a custom ID.

* id

  [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID)

  non-null Token access required

  A globally-unique ID.

* online​Store​Url

  [URL](https://shopify.dev/docs/api/storefront/latest/scalars/URL)

  Token access required

  The URL used for viewing the metaobject on the shop's Online Store. Returns `null` if the metaobject definition doesn't have the `online_store` capability.

* seo

  [Metaobject​SEO](https://shopify.dev/docs/api/storefront/latest/objects/MetaobjectSEO)

  Token access required

  The metaobject's SEO information. Returns `null` if the metaobject definition doesn't have the `renderable` capability.

* type

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null Token access required

  The type of the metaobject. Defines the namespace of its associated metafields.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime)

  non-null Token access required

  The date and time when the metaobject was last updated.

***

## Map

### Fields and connections with this object

* <->[MetaobjectConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/MetaobjectConnection#returns-nodes)
* {}[MetaobjectEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/MetaobjectEdge#field-MetaobjectEdge.fields.node)

### Possible type in

* [Menu​Item​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MenuItemResource)
* [Metafield​Reference](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldReference)

***

## Queries

* [metaobject](https://shopify.dev/docs/api/storefront/latest/queries/metaobject)

  query

  Fetch a specific Metaobject by one of its unique identifiers.

* [metaobjects](https://shopify.dev/docs/api/storefront/latest/queries/metaobjects)

  query

  All active metaobjects for the shop.

***

## \<?>Metaobject Queries

### Queried by

* \<?>[metaobject](https://shopify.dev/docs/api/storefront/latest/queries/metaobject)
* \<?>[metaobjects](https://shopify.dev/docs/api/storefront/latest/queries/metaobjects)

***

## Interfaces

* * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)

    interface

  * [Online​Store​Publishable](https://shopify.dev/docs/api/storefront/latest/interfaces/OnlineStorePublishable)

    interface

***

## ||-Metaobject Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)
* ||-[Online​Store​Publishable](https://shopify.dev/docs/api/storefront/latest/interfaces/OnlineStorePublishable)