# Metaobject - admin-graphql - OBJECT
Version: 2024-04

## Description
Provides an object instance represented by a MetaobjectDefinition.

### Access Scopes
`read_metaobjects` access scope.


## Fields
* [capabilities](/docs/api/admin-graphql/2024-04/objects/MetaobjectCapabilityData): MetaobjectCapabilityData! - Metaobject capabilities for this Metaobject.
* [createdBy](/docs/api/admin-graphql/2024-04/objects/App): App! - The app used to create the object.
* [createdByApp](/docs/api/admin-graphql/2024-04/objects/App): App! - The app used to create the object.
* [createdByStaff](/docs/api/admin-graphql/2024-04/objects/StaffMember): StaffMember - The staff member who created the metaobject.
* [definition](/docs/api/admin-graphql/2024-04/objects/MetaobjectDefinition): MetaobjectDefinition! - The MetaobjectDefinition that models this object type.
* [displayName](/docs/api/admin-graphql/2024-04/scalars/String): String! - The preferred display name field value of the metaobject.
* [field](/docs/api/admin-graphql/2024-04/objects/MetaobjectField): MetaobjectField - The field for an object key, or null if the key has no field definition.
* [fields](/docs/api/admin-graphql/2024-04/objects/MetaobjectField): MetaobjectField! - All ordered fields of the metaobject with their definitions and values.
* [handle](/docs/api/admin-graphql/2024-04/scalars/String): String! - The unique handle of the object, useful as a custom ID.
* [id](/docs/api/admin-graphql/2024-04/scalars/ID): ID! - A globally-unique ID.
* [staffMember](/docs/api/admin-graphql/2024-04/objects/StaffMember): StaffMember - The staff member who created the metaobject.
* [thumbnailField](/docs/api/admin-graphql/2024-04/objects/MetaobjectField): MetaobjectField - The recommended field to visually represent this metaobject. May be a file reference or color         field.
* [type](/docs/api/admin-graphql/2024-04/scalars/String): String! - The type of the metaobject.
* [updatedAt](/docs/api/admin-graphql/2024-04/scalars/DateTime): DateTime! - When the object was last updated.

## Connections
* [referencedBy](/docs/api/admin-graphql/2024-04/connections/MetafieldRelationConnection): MetafieldRelationConnection!



## Related queries
* [metaobject](/docs/api/admin-graphql/2024-04/queries/metaobject) Retrieves a metaobject by ID.
* [metaobjectByHandle](/docs/api/admin-graphql/2024-04/queries/metaobjectByHandle) Retrieves a metaobject by handle.
* [metaobjects](/docs/api/admin-graphql/2024-04/queries/metaobjects) All metaobjects for the shop.

## Related mutations
* [metaobjectCreate](/docs/api/admin-graphql/2024-04/mutations/metaobjectCreate) Creates a new metaobject.
* [metaobjectUpdate](/docs/api/admin-graphql/2024-04/mutations/metaobjectUpdate) Updates an existing metaobject.
* [metaobjectUpsert](/docs/api/admin-graphql/2024-04/mutations/metaobjectUpsert) Retrieves a metaobject by handle, then updates it with the provided input values.
If no matching metaobject is found, a new metaobject is created with the provided input values.

## Related Unions
* [MetafieldReference](/docs/api/admin-graphql/2024-04/unions/MetafieldReference) The resource referenced by the metafield value.
* [MetafieldReferencer](/docs/api/admin-graphql/2024-04/unions/MetafieldReferencer) Types of resources that may use metafields to reference other resources.

## Examples