> For the complete documentation index, see [llms.txt](https://docs.hotwax.co/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hotwax.co/documents/learn-shopify/shopify-integration/products/update-product-details.md).

# Updating Product Details

Merchants use Shopify to update product information such as names, images, tags, and weight. HotWax Commerce identifies these changes as part of the product download.

### Identify updates with diff computation

Instead of comparing every individual field during every sync, HotWax uses diff computation to find exactly what changed. The system groups product data and computes a unique digital signature (SHA-256 hash) for each group.

HotWax compares the incoming hashes against the baseline stored in the `ProductUpdateHistory` table. If the hashes match, no changes occurred and the system skips that data. If the hashes differ, the system identifies the exact delta (what was added, removed, or changed) and applies only those specific updates to the database.

### Product field mapping

HotWax maps the fields from the Shopify JSON to the internal product entities. The following table outlines how these fields are synchronized:

| Shopify JSON field | HotWax field       | Description                                     |
| ------------------ | ------------------ | ----------------------------------------------- |
| `id` (GID)         | Shopify Product ID | A unique ID used to identify the product.       |
| `title`            | Product Name       | The name shown for the product.                 |
| `handle`           | Internal Name      | Used in the product’s URL and for internal use. |
| `vendor`           | Brand              | The brand or company that makes the product.    |
| `category`         | Category           | The category the product belongs to.            |
| `tags`             | Keywords           | Tags used to search and organize products.      |
| `variants.sku`     | SKU                | A unique code to track the product.             |
| `variants.barcode` | UPCA/GTIN          | Barcode used for scanning the product.          |
| `variants.price`   | Price              | The selling price of the product.               |
| `variants.weight`  | Weight             | The product’s weight, used for shipping.        |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hotwax.co/documents/learn-shopify/shopify-integration/products/update-product-details.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.