update_metaobject
Update an existing metaobject's handle, field values, or publishable status. Fields are upserted by key; omitted fields remain unchanged. Optionally redirect old handle to new one.
Instructions
Update an existing metaobject's handle, field values, or publishable status. Fields are upserted by key — pass only the fields you want to change; omitted fields keep their current values. To clear a field, pass an empty string or null-ish value matching the field type. If you change the handle, set redirectNewHandle=true to have Shopify redirect from the old handle on the storefront. The type cannot be changed by this tool — delete and recreate to change type.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "update_metaobject"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | GID of the metaobject to update. | |
| handle | No | New handle. Changes the storefront URL slug. Pair with redirectNewHandle=true to keep old links working. | |
| fields | No | Field-level upserts: only the keys present here are written; other fields keep their current values. Pass empty string to clear a field. | |
| status | No | New publishable status (only for publishable types). Omit to leave unchanged. | |
| redirectNewHandle | No | If true and `handle` is being changed, Shopify creates a 301 redirect from the old handle to the new one on the storefront. |