---
title: metaobject - Storefront API
description: Fetch a specific Metaobject by one of its unique identifiers.
api_version: 2025-10
api_name: storefront
type: query
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/queries/metaobject'
  md: 'https://shopify.dev/docs/api/storefront/latest/queries/metaobject.md'
---

# metaobject

query

Requires `unauthenticated_read_metaobjects` access scope.

Fetch a specific Metaobject by one of its unique identifiers.

## Arguments

* handle

  [Metaobject​Handle​Input](https://shopify.dev/docs/api/storefront/latest/input-objects/MetaobjectHandleInput)

  The handle and type of the metaobject.

* id

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

  The ID of the metaobject.

***

## Possible returns

* Metaobject

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

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

  * field

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

    Token access required

    Accesses a field of the object by key.

    * key

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

      required

      ### Arguments

      The key of the field.

    ***

  * 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.

  * 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.

***

## Examples

* ### metaobject reference

## Query Reference

```graphql
{
  metaobject {
    # metaobject fields
  }
}
```