> 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-reference/products/update-product-details.md).

# Updating Product Details

Learn how HotWax Commerce identifies product updates between Shopify and the order management system (OMS).

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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.