Shopistuff icon

Shopistuff

Consume Shopify API
Join our community

Actions14

Overview

The Shopistuff node for n8n allows you to interact with the Shopify API, specifically to update product information. The "Product → Update" operation enables users to modify details of an existing product in their Shopify store. This is useful for automating catalog management tasks such as updating product descriptions, images, tags, options (like size or color), and other attributes.

Common scenarios:

  • Bulk updating product details from another system.
  • Automating changes to product availability, tags, or categorization.
  • Synchronizing product data between Shopify and external databases or ERPs.

Example:
Automatically update the description and images of a product when new marketing material becomes available.

Properties

Name Type Meaning
Product ID String The unique identifier of the product to update. Required.
Update Fields Collection A set of fields to update on the product. Each field below can be included as needed:
  Body HTML String A description of the product. Supports HTML formatting.
  Handle String A unique, human-friendly string for the product, used in URLs and templates.
  Images Collection (multiple) List of image objects associated with the product. Each image can include: Created At (dateTime), ID (number), Position (number), Product ID (number), Variant IDs (array of numbers), Source (string/URL), Width (number), Height (number), Updated At (dateTime).
  Options Fixed Collection (multiple) Custom product property names like Size, Color, Material. Up to 3 options. Each option has a Name (string) and Value (string).
  Product Type String Categorization for filtering/searching products.
  Published At DateTime When the product was published (ISO 8601 format). Set to null to unpublish.
  Published Scope Options Where the product is published: Global (Online Store + POS) or Web (Online Store only).
  Tags String Comma-separated tags for filtering/search. Up to 250 tags, each up to 255 characters.
  Template Suffix String Suffix for the Liquid template used for the product page. If empty/null, uses default template.
  Title String The name/title of the product.
  Vendor String The name of the product's vendor.

Output

  • The output is a JSON object representing the updated product as returned by the Shopify API.
  • The structure includes all standard Shopify product fields, such as id, title, body_html, images, options, tags, etc., reflecting the current state after the update.
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output:

{
  "id": 123456789,
  "title": "Updated Product Title",
  "body_html": "<p>New description</p>",
  "images": [
    {
      "id": 987654321,
      "src": "https://example.com/image.png"
    }
  ],
  "options": [
    { "name": "Size", "values": ["M", "L"] }
  ],
  "tags": "new,featured",
  ...
}

Dependencies

  • External Service: Requires access to a Shopify store and valid Shopify API credentials.
  • n8n Credentials: You must configure the shopistuffApi credential in n8n with your Shopify API key and password/access token.

Troubleshooting

Common issues:

  • Invalid Product ID: If the provided Product ID does not exist, the node will throw an error indicating the product could not be found.
  • Missing Required Fields: If required fields are missing (e.g., Product ID), the node will fail with a relevant error message.
  • API Permission Errors: Insufficient permissions in the Shopify API credentials may result in authentication or authorization errors.
  • Malformed Images/Options: Incorrectly structured image or option data may cause the update to fail.

Error messages and resolutions:

  • "At least one line item has to be added": Not applicable for product update, but similar validation errors may occur if required subfields are missing.
  • "Not Found" or "404": Check that the Product ID is correct and exists in your Shopify store.
  • "Invalid API Key" or "Unauthorized": Verify your Shopify API credentials in n8n.

Links and References

Discussion