---
title: metaobjects - Storefront API
description: >-
  Returns a paginated list of
  [`Metaobject`](/docs/api/storefront/2026-10/objects/Metaobject)

  entries for a specific type. Metaobjects are [custom data

  structures](https://shopify.dev/docs/apps/build/metaobjects) that extend

  Shopify's data model with merchant-defined or app-defined content like size

  charts, product highlights, or custom sections.


  The required `type` argument specifies which metaobject type to retrieve. You

  can sort results by `id` or `updated_at` using the `sortKey` argument.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/queries/metaobjects'
  md: 'https://shopify.dev/docs/api/storefront/latest/queries/metaobjects.md'
api_name: storefront
api_type: graphql
type: query
---

# metaobjects

query

Requires `unauthenticated_read_metaobjects` access scope.

Returns a paginated list of [`Metaobject`](https://shopify.dev/docs/api/storefront/2026-10/objects/Metaobject) entries for a specific type. Metaobjects are [custom data structures](https://shopify.dev/docs/apps/build/metaobjects) that extend Shopify's data model with merchant-defined or app-defined content like size charts, product highlights, or custom sections.

The required `type` argument specifies which metaobject type to retrieve. You can sort results by `id` or `updated_at` using the `sortKey` argument.

## MetaobjectConnection arguments

[MetaobjectConnection!](https://shopify.dev/docs/api/storefront/latest/connections/MetaobjectConnection)

* after

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

  Returns the elements that come after the specified cursor.

* before

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

  Returns the elements that come before the specified cursor.

* first

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

  Returns up to the first `n` elements from the list.

* last

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

  Returns up to the last `n` elements from the list.

* reverse

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

  Default:false

  Reverse the order of the underlying list.

* sort​Key

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

  The key of a field to sort with. Supports "id" and "updated\_at".

* type

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

  required

  The type of metaobject to retrieve.

***

## Possible returns

* edges

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

  non-null

  A list of edges.

* nodes

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

  non-null

  A list of the nodes contained in MetaobjectEdge.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/storefront/latest/objects/PageInfo)

  non-null

  Information to aid in pagination.

***

## Examples

* ### metaobjects reference