Update metafield definition

PUT 
/openapi/2026-07/metafield_definition/:id

Update an existing metafield definition.

Request

Path Parameters

id uint64required

The unique identifier for the metafield definition

application/json

Body

Bodyrequired

descriptionstring

Updated description of the metafield definition

namestring

Updated name of the metafield definition

Example

{
  "description": "string",
  "name": "string"
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

metafield_definition object

The updated metafield definition

idstring

The unique identifier for the metafield definition

keystring

The key of the metafield (unique within the namespace). For example, "color"

namestring

Name of the metafield definition (displayed in the admin panel)

namespacestring

A container for a group of metafields. Grouping metafields within a namespace prevents your metafields from conflicting with other metafields with the same key name. For example, "global"

owner_resourcestring

Resource type the metafield definition is attached to:

• shop: Shop
• product: Product
• product_image: Product image
• product_variant: Product variant
• order: Order
• page: Custom page
• customer: Customer
• collection: Collection
• blog: Blog
• article: Article
• app: App

typestring

Field type of the metafield:

• date: Date
• date_time: Date and time
• weight: Weight
• volume: Volume
• dimension: Dimension
• integer: Integer
• number_decimal: Decimal
• file_reference: File reference
• single_line_text_field: Single-line text
• multi_line_text_field: Multi-line text
• json: JSON
• color: Color
• rating: Rating
• url: URL
• boolean: Boolean (true or false)
• string: String

descriptionstring

A brief description of the metafield definition

create_atstring

Creation timestamp, in ISO-8601 format

updated_atstring

Last update timestamp, in ISO-8601 format

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "metafield_definition": {
      "id": "string",
      "key": "string",
      "name": "string",
      "namespace": "string",
      "owner_resource": "string",
      "type": "string",
      "description": "string",
      "create_at": "string",
      "updated_at": "string"
    }
  }
}