Shopify Collections icon

Shopify Collections

Create and manage Shopify collections through the Admin GraphQL API

Actions6

Collection → Update

AI-generated

Summary

Update an existing Shopify collection by specifying its GraphQL ID and modifying properties such as title, handle, description, sorting, SEO data, image, metafields, and smart collection rules. Optionally, publish the updated collection immediately to selected publications with or without a scheduled future publish date.

Inputs

  • Collection ID (required) — GraphQL collection ID of the collection to update.
  • Collection Type — Type of the collection to update; either manual or smart. Determines the applicable fields and rules.
  • Title (required) — New title for the collection.
  • Handle — Optional SEO-friendly handle for the collection; leave empty to auto-generate.
  • Description HTML — HTML-formatted description of the collection.
  • Sort Order — Collection sorting order preference.
  • Template Suffix — Theme template suffix used for the collection.
  • SEO Title — SEO title override for the collection.
  • SEO Description — SEO description override for the collection.
  • Image URL — Public URL for the collection image.
  • Image Alt Text — Alternative text for the collection image.
  • Match Mode — For smart collections only: whether all or any rules must match.
  • Rules JSON — For smart collections only: JSON array of rules defining the collection criteria; each rule must include column, relation, and condition, with optional conditionObjectId.
  • Metafields JSON — JSON array of metafields to associate with the collection; each must have namespace, key, type, and value.
  • Publish Immediately — Whether to immediately publish the collection after update.
  • Publication IDs — List of publication IDs to which the collection should be published.
  • Publish Date — Optional future date and time to schedule collection publication; only applicable for online store channels.
  • Return Full Response — Whether to return the raw Shopify GraphQL response instead of just the updated collection data.

Output shape

a single JSON object representing the updated collection or the full GraphQL response if requested

Returns a single collection object with fields including id, title, handle, descriptionHtml, sortOrder, templateSuffix, SEO info, image details, rules for smart collections, and metafields. Can return the full raw Shopify GraphQL mutation response if 'Return Full Response' is true. Errors from Shopify are surfaced as workflow errors.

Links

Discussion