---
title: Metaobject - Customer API
description: An instance of a user-defined model based on a MetaobjectDefinition.
api_version: unstable
api_name: customer
source_url:
  html: https://shopify.dev/docs/api/customer/unstable/objects/metaobject
  md: https://shopify.dev/docs/api/customer/unstable/objects/metaobject.md
---

# Metaobject

object

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

## Fields

* field

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

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  Accesses a field of the object by key.

  * key

    [String!](https://shopify.dev/docs/api/customer/unstable/scalars/String)

    required

    ### Arguments

    The key of the field.

  ***

* fields

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  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/customer/unstable/scalars/String)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

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

* id

  [ID!](https://shopify.dev/docs/api/customer/unstable/scalars/ID)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A globally-unique ID.

* type

  [String!](https://shopify.dev/docs/api/customer/unstable/scalars/String)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The type of the metaobject.

* updated​At

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The date and time when the metaobject was last updated.

***

## Map

### Possible type in

* [Metafield​Reference](https://shopify.dev/docs/api/customer/unstable/unions/MetafieldReference)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/customer/unstable/interfaces/Node)

  interface

***

## ||-Metaobject Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/customer/unstable/interfaces/Node)