--- 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) Accesses a field of the object by key. * fields [\[Metaobject​Field!\]!](https://shopify.dev/docs/api/storefront/latest/objects/MetaobjectField) non-null 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 The unique handle of the metaobject. Useful as a custom ID. * id [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID) non-null A globally-unique ID. * online​Store​Url [URL](https://shopify.dev/docs/api/storefront/latest/scalars/URL) 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) 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 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 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/MetaobjectConnection) *** ## 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)