Skip to main content
PUT
Update Collection

Update Collection

Updates an existing collection. Only provided fields are updated. Requires the write_products scope.

Request

Path Parameters

id
string
required
The unique collection ID to update

Body Parameters

All parameters are optional. Only the four fields below are applied; any other field in the request body is accepted but ignored.
title
string
The collection title
description
string
Collection description (supports HTML). This is the field that updates the collection body — it is returned as body_html (and description) on read.
handle
string
URL-safe handle
image
string
URL of the collection featured image. Pass null to remove.

Response

The response is a bare object keyed by collection containing the updated, Shopify-shaped collection object (the same shape returned by the read endpoints). There is no { status, data } envelope.
collection
object
The updated collection object

Example Response

Errors

Errors are returned as a Shopify-style { "errors": { "base": ["..."] } } body with the corresponding HTTP status code.
StatusDescription
401Invalid or missing access token
403App doesn’t have the write_products scope
404Collection with the specified ID does not exist