> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Update Product
> Update a master catalog product.
Updates the product's details; only the provided fields are changed.
## Path parameters
The product's ID.
## Body parameters
Product title.
Product subtitle.
Product description.
Unique URL-safe handle.
One of `draft`, `proposed`, `published`, `rejected`.
Whether the product is a gift card.
Whether discounts can apply to the product.
URL of the product thumbnail.
Product images; replaces the existing set.
Existing image ID to keep.
Image URL.
ID of the product in an external system.
ID of the product type.
ID of the collection to assign the product to.
Categories to assign; replaces the existing set.
Category ID.
Tags to assign; replaces the existing set.
Tag ID.
Product options; replaces the existing set.
Option title.
Possible option values.
Variants to upsert; include `id` to update an existing variant.
Existing variant ID.
Variant title.
Variant SKU.
Variant EAN.
Variant UPC.
Variant ISBN.
Variant ASIN.
Variant GTIN.
Variant barcode.
Harmonized System code.
Manufacturer identification code.
URL of the variant thumbnail.
Sort rank of the variant.
Variant weight.
Variant length.
Variant height.
Variant width.
Country of origin.
Variant material.
Prices with `id`, `currency_code`, `amount`, `min_quantity`, `max_quantity`, and `rules`.
Map of option title to option value.
Custom key-value data.
Product weight.
Product length.
Product height.
Product width.
Harmonized System code.
Manufacturer identification code.
Country of origin.
Product material.
Custom key-value data.
Custom data passed to workflow hooks.
## Response
The product's ID.
Product title.
One of `draft`, `proposed`, `published`, `rejected`.
Product variants.
Attribute values selected on the product.
Product-scoped (inline) attributes.
Last update timestamp.
```bash cURL theme={null}
curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF' \
-H 'Authorization: Bearer ' \
-H 'Content-Type: application/json' \
-d '{"title": "Linen Shirt v2", "status": "published"}'
```
```ts JS Client theme={null}
const { product } = await client.admin.products.$id.mutate({
$id: "prod_01HXYZABCDEF",
title: "Linen Shirt v2",
status: "published",
})
```
```json 200 theme={null}
{
"product": {
"id": "prod_01HXYZABCDEF",
"title": "Linen Shirt v2",
"handle": "linen-shirt",
"status": "published",
"updated_at": "2026-06-02T09:00:00.000Z"
}
}
```