metaobject

query

Requires unauthenticated_read_metaobjects access scope.

An access token is required to call this API. Refer to Authorization for more information about how to obtain the token.

Get a metaobject.

Arguments

id ● String

The ID of the metaobject.

handle ● MetaobjectHandleInput

The identifier of the metaobject.

Return

fields ● [MetaobjectField!]!non-null

List of metafields.

handle ● String!non-null

The unique identifier of the metaobject.

id ● ID!non-null

The ID of the metaobject.

type ● String!non-null

The type of the metaobject.

updatedAt ● Date!non-null

The date and time when the metaobject was updated.
Format: ISO 8601.

createdAt ● Date!non-null

The date and time when the metaobject was created.
Format: ISO 8601.

Status and error codes

For detailed information about common codes, see Status and error codes.

Example

Get a metaobject

Code

query GetMetaobject($id: String!) {
  metaobject(id: $id) {
    id
    type
    handle
    fields {
      key
      type
      value
    }
    createdAt
    updatedAt
  }
}

Response

{
	"data": {
		"metaobject": {
			"updatedAt": "2026-04-08T03:20:00Z",
			"createdAt": "2026-04-08T02:40:00Z",
			"fields": [
				{
					"value": "100% Organic Cotton",
					"key": "fabric_name",
					"type": "single_line_text_field"
				},
				{
					"key": "washing_temperature",
					"type": "number_integer",
					"value": "40"
				},
				{
					"key": "is_machine_washable",
					"type": "boolean",
					"value": "true"
				},
				{
					"key": "care_instructions",
					"type": "multi_line_text_field",
					"value": "Machine wash warm. Do not bleach. Line dry in shade."
				}
			],
			"handle": "cotton_basic_care",
			"id": "9876543210",
			"type": "material_care_guide"
		}
	}
}

Was this article helpful to you?

SHOPLINE

Legal