For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Manage products in the Products app

Use the Products app to find catalog records, edit product setup, repair common data gaps, and review recent product updates in your order management system (OMS). Open the app from Launchpad, then use the side menu to move between each workflow.

Before you begin

The pages and edit actions available to you depend on your permissions. If a page or action described here is not visible, ask your administrator for access.

Before editing categories or prices, open Settings and confirm the current Product Store. This selection provides the store context for those changes. It is separate from the Product store filter on the Product workbench.

1. Find and triage products

Goal: Narrow the catalog to the products that need review and open the correct product or variant.

Use this flow when: You know a product ID, SKU, UPC, or name. You can also use this flow to review products that share a type, store, virtual or variant status, or tag.

Key labels: Product workbench, Product ID, SKU, UPC, name, Product type, Product store, Virtual/variant, Tags, Clear filters, {shown} of {count} matching products, Select, Done, Add tag.

  1. Open Products > Product workbench.

  2. Search by product ID, SKU, UPC, or product name. The search runs when you pause typing.

  3. Narrow the results with Product type, Product store, Virtual/variant, or Tags.

  4. If an expected product is missing, select Clear filters. It clears the search and tags, and resets the other filters and the sort.

  5. Use the sort button in the list header to change the order:

    • Newest introduced (the default) or Oldest introduced

    • Recently updated or Least recently updated

    • Product family, which lists each virtual product ahead of its variants

    • Name A–Z, Name Z–A, SKU A–Z, or SKU Z–A

    • Price: high to low or Price: low to high, by the list price in the filtered store's group and currency. These choices appear only when that store has a store group and currency. Unpriced products come last.

  6. Check the list header, for example 25 of 1,986 matching products. More rows load as you scroll.

  7. Review each row: the product image, the primary and secondary identifiers chosen in Settings (see Choose the product identifier), the variant count for a virtual product, Pre-order or Back-order badges, tags, and 30-day sales.

  8. Select a row to open the product.

The search text, filters, tags, and sort stay in place when you reload the page.

Outcome: You have isolated the relevant records and opened the correct product for detailed review.

Add a tag to several products

  1. Find the products with the search and filters.

  2. Select Select in the list header. In select mode, selecting a row selects it instead of opening the product.

  3. Select the rows to tag, or use the header checkbox to select every loaded row. The footer shows {n} selected.

  4. Select Add tag in the footer. Check the existing tags to add and select Add. To add a tag that doesn't exist yet, type it in Search or enter new tag and select Add "<tag>".

  5. Wait while the app shows Updating products.... It then reports how many products it tagged, or how many it couldn't tag.

  6. Select Done to leave select mode.

A new search, filter, or sort keeps only the selected products that are still listed, so a product hidden by the search isn't tagged.

2. Inspect and edit product details

Goal: Confirm the product family and update the correct parent or variant without overwriting unrelated product data.

Use this flow when: A product has the wrong display data, identifiers, dates, tags, categories, prices, shop mapping, inventory policy, shipping data, or kit components.

Key labels: Product details, Features, Edit parent, Edit variant, Display, Product identifications, Dates, Tags, Categories, Prices, Shopify Shop Products, Inventory policy, Shipping and handling, Components, Change history, Save, Reset.

  1. Open the product from the Product workbench.

  2. For a product family, use the feature options or variant strip to select the variant you want to inspect.

  3. Select Edit parent for shared parent data or Edit variant for data that belongs to the selected variant.

  4. Use the section that matches the task. For example, use Display for the name, description, brand, or product type; Product identifications for SKU or UPC; and Categories or Prices for store-specific setup.

  5. Complete the action for that section. Display, Dates, Prices, Inventory policy, and Shipping and handling use card-level Save and Reset actions. Product identifications lists each identifier's type and value and uses an edit dialog (Edit). Tags apply add or remove actions directly. Categories and Shopify Shop Products open a dialog with its own save action.

  6. For sections with a Save footer, save each changed card. Select Reset to restore that card's editable fields. Staged substitute and component links have the additional behavior described below. If the app reports Underlying data changed, review the latest data before saving again.

  7. Use Change history to review recorded changes to identifier values and facility settings. Each entry names what changed, such as SKU or Minimum stock at Broadway, and how: Set to {value}, Cleared, was {value}, or {from} to {to}, with when and who made it. Select Show more for older entries. Use Imports for recent shop product update records.

Outcome: The app updates the intended parent or variant data, while card-level drafts remain separate.

Product details for an Abominable Hoodie variant from the demo OMS
Inspect product details and select the intended variant

Update shipping dimensions with the visualizer

Goal: Record the physical measurements and shipping controls for the correct product or variant, and use the dimension visualizer to catch obvious entry errors before saving.

Use this flow when: Package dimensions, weight, box type, or the In shipping box and Charge shipping settings are missing or incorrect.

  1. Open the product and select Edit parent or Edit variant, depending on where the shipping data belongs.

  2. In Shipping and handling, select a Default box type when your shipping process requires one.

  3. Enter Width, Height, and Depth, and confirm the unit beside each value. Enter Weight and confirm its unit.

  4. Review the box visualizer. It changes proportionally as you enter all three dimensions, which can help you spot a transposed or unusually large value. It does not calculate volume, validate box fit, or quote a shipping rate.

  5. Set In shipping box and Charge shipping as required by your shipping policy.

  6. Select Save. Select Reset to restore the saved shipping draft instead.

  7. For a variant, select Copy from parent when the parent already has the correct values. Review the copied draft, then select Save; copying alone does not save the variant.

Outcome: The intended product record has saved shipping measurements and controls, and the visualizer reflects the relative proportions of the three dimensions.

Shipping and handling card for an Abominable Hoodie variant with unsaved example dimensions in the visualizer
Check the relative dimensions before saving shipping data

Goal: Record another catalog item that operators may use as a replacement for the product you are editing.

Use this flow when: Merchandising or operations has approved another product as an acceptable substitute for an unavailable item.

  1. Open the product ID that appears on the order item. If orders contain a variant, select Edit variant and configure that variant; downstream workflows do not fall back to a substitute link on its parent.

  2. In Inventory policy, find Substitutes and select Add.

  3. In Add substitute, search by Product ID, SKU, name, then select the approved replacement product.

  4. Select the checkmark button to return to Inventory policy. Review the staged substitute and select Save on the card.

  5. Before saving, select Expire beside a staged substitute to remove it, or select Reset to clear all staged substitutes and restore the policy fields.

  6. For a saved link, select Expire when the replacement is no longer approved. Select Reactivate to make an expired link active again.

  7. Repeat the setup from the other product if either item may replace the other. A substitute link runs from the current product to the product you select; it is not automatically reciprocal.

Order Manager can offer active linked products during Swap review and show whether inventory is available at the same facility. Saving the link does not rebroker an order or replace an order item by itself. The order workflow still applies the actual swap.

Outcome: The current product has an active, directional link to an approved replacement, ready for the downstream workflows that use substitutes.

Inventory policy card staging Juno Jacket from the demo OMS as a substitute
Review the staged substitute before saving Inventory policy

Set up pick-assembly kit components

Goal: Define the products and quantities required to assemble one pick-assembly kit.

Use this flow when: Fulfillment teams assemble a sellable kit from tracked component products.

  1. Create the kit product first if it does not already exist, then reopen it in Product details.

  2. Select the Edit parent or Edit variant context for the product ID sold on the order. If orders contain a variant, configure the components on that variant; reservation processing does not fall back to component links on its parent.

  3. In Display, set Type to Marketing Package: Pick Assembly. The Components area appears in the same card.

  4. Under Components, select Add, then search for and select each component product.

  5. Set Qty to the number of component units required for one kit. For example, a component with Qty 2 requires six units for an order of three kits.

  6. Select the checkmark button. Review the staged components and quantities, then select Save on the Display card. This saves the type change and creates the staged component links.

  7. Before saving, select Expire beside a staged component to remove it. For a saved component, use Expire or Reactivate to change whether the link is active.

For pick-assembly kits, OMS uses the active component links and quantities when it creates and releases inventory reservations. Changing a live kit is operationally sensitive because reservation processing reads the current active links.

Products can show a separate Components card for other marketing-package types. Confirming that picker creates the component link immediately, but downstream fulfillment behavior can differ. Use Marketing Package: Pick Assembly for the reservation flow described here.

Outcome: The pick-assembly kit has active component links with the quantity required for one kit.

Display card staging a demo OMS product as a quantity-two component of Beaumont Summit Kit
Set the kit type, component, and per-kit quantity before saving Display

Update categories

Goal: Add the product to the store's catalog categories it belongs in, and remove it from the ones it doesn't.

Use this flow when: A product is missing from a category, or sits in a category it shouldn't.

  1. Confirm the current Product Store in Settings. The list shows that store's catalog categories.

  2. Open the product and select Edit parent or Edit variant.

  3. In Categories, select Edit categories.

  4. Use Search categories to filter by category name, description, or ID. The categories the product is in now start checked.

  5. Check the categories to add and uncheck the ones to remove. Selecting a row toggles its checkbox.

  6. Select the save button. It's available only after a change. Saving adds the product to the newly checked categories and ends its membership in the unchecked ones.

Outcome: The product's categories match the checked list. Removing a category ends the membership rather than deleting it, so its history stays on record.

Update prices

Goal: Replace a product's price in the current store's store group, or give a variant its parent's prices.

Use this flow when: A price is wrong, or a variant is missing prices its parent has.

The Prices card lists the prices the product already has in the primary store group of the Product Store selected in Settings. It shows one field per price type and currency, with the store's currency first. A product with no prices in that group shows No prices in this store group.

  1. Confirm the current Product Store in Settings.

  2. Open the product and select Edit parent or Edit variant.

  3. In Prices, enter the new value in the price field you want to change. A changed price must be a positive number. You can replace a price but not clear it.

  4. For a variant, select Copy from parent to fill in the parent's prices for the store group, including price types and currencies the variant doesn't have yet. Review the copied values. Copying alone doesn't save them.

  5. Select Save, or Reset to discard the changes.

Saving retires each changed price and creates its replacement. The replacement keeps the purpose of the price it replaces, and stays PURCHASE whenever a PURCHASE price is among those replaced, because orders and the Shopify connector read PURCHASE prices.

Outcome: The product has one active price per changed price type and currency in the store group.

Goal: Keep the product's links to its Shopify product and inventory item correct for each shop.

Use this flow when: A product shows the wrong Shopify ID, is missing a Shopify link, or no longer exists on Shopify.

The Shopify Shop Products card lists each link with its shop, the Shopify product ID and Shopify inventory ID, the last 30 days of Shopify orders, and the Shopify inventory. When the card first comes into view, the app looks up each link on Shopify and flags problems on the row:

  • No Shopify ID saved

  • Not found on Shopify

  • Inventory ID differs on Shopify

  1. To fix a flagged link, select Review Shopify values when the row offers it. The edit dialog opens with the values Shopify has. Review them, then select Save. Otherwise, select Edit and correct the IDs.

  2. To add a link, select Add, then pick the Shop:

    • In From Shopify, search the shop's variants (or products, for a virtual product) and check the ones to link. You can't pick an ID that another product already has; the list shows which product has it.

    • In Enter manually, type the Shopify product ID and, if you have it, the Shopify inventory ID. After you pause typing, the app looks up the ID on Shopify and shows its title, 30-day orders, and inventory. When Shopify's inventory ID differs, select Use Shopify's to fill it in.

  3. Select Save.

  4. To change a link's IDs, select Edit on its row. The app saves a new Shopify ID as a new link before it removes the old one, so a failed change leaves the old link in place. Select Remove to remove a link; the app removes it at once, without a confirmation. On a verified link, select Open on Shopify to open the product in Shopify admin.

Each Shopify ID belongs to one product per shop. If another product already has the ID you enter, the dialog shows Linked to another product on this shop. with that product, and you can't save it: unlink it on that product first. If Shopify doesn't have the ID, or the app can't reach Shopify for that shop, you can still save after checking Save anyway; this link may not sync until Shopify has this ID.

Outcome: Each link points to the right Shopify product and inventory item, and no two products on one shop share a Shopify ID.

3. Resolve duplicate identifiers

Goal: Give each product a unique SKU or UPC so operators and integrations can identify the correct record.

Use this flow when: Duplicate identifiers shows a duplicate group, or a known SKU or UPC points to more than one product.

Key labels: Duplicate identifiers, SKU, UPC, Resolve N products, Resolve SKU, Resolve UPC, Save N changes.

  1. Open Products > Duplicate identifiers.

  2. Select SKU to review duplicate SKUs across products, or UPC to review duplicate UPCs on variants.

  3. Open a duplicate group with Resolve N products.

  4. Confirm each listed product, then replace the duplicate value with the correct unique SKU or UPC.

  5. Select Save N changes.

  6. Refresh the page and confirm that the corrected group no longer appears.

Outcome: Each product in the group has a distinct identifier, and the corrected group leaves the page after the updated data becomes available.

Resolve SKU dialog for two demo OMS records with one unique value staged
Assign a unique value to each product in a duplicate group

4. Find and fix missing values

Goal: Prioritize common catalog gaps and update the affected products from the appropriate product details card.

Use this flow when: A product is missing an image, tags, brand, UPC, SKU, or primary category, or when you are performing a catalog quality review.

Key labels: Missing values, Catalog coverage, Image, Tags, Brand, UPC, SKU, Primary category, Image URL, Display, Product identifications, Categories.

  1. Open Products > Missing values.

  2. Review Catalog coverage. The page orders the cards with the largest gaps first.

  3. Select Image, Tags, Brand, UPC, SKU, or Primary category to list the affected products.

  4. Open a product from the list.

  5. Update the matching area in Product details:

    • Select the product image and update Image URL for a missing image.

    • Use Display for a missing brand.

    • Use Product identifications for a missing SKU or UPC.

    • Use Tags for a missing tag.

    • Use Categories to add the intended category when Primary category is missing. The app does not provide a control to designate a category as primary, so escalate the product ID if the gap remains.

  6. Complete the section's save or add action. Return to Missing values and confirm the product leaves the affected list after the updated search data becomes available.

Outcome: You have completed the available repair or identified a primary-category gap that needs administrator support. Catalog coverage reflects completed repairs after the search data refreshes.

Demo OMS catalog coverage with Beaumont Summit Kit variants missing a brand
Prioritize and open products with missing values

5. Review product import history and diagnose stale updates

Goal: Determine whether Imports contains a recent shop product update snapshot and collect useful evidence when the product still looks stale.

Use this flow when: A shop-originated product change is not visible in Product details or the Product workbench. Use it also to compare recent snapshots for a product or shop.

Key labels: Imports, Refresh, Last 100 recently synced product updates, Synced, Recorded, Shop, System message.

  1. Open Products > Imports and select Refresh to load the latest records. The page shows the latest 100 records, not a complete event history.

  2. Search by product ID, parent product ID, displayed SKU, shop, or system message.

  3. Compare the displayed timestamp and Shop with the change you expected.

  4. Read the badge as an update-record detail:

    • Synced means the record includes a System message value.

    • Recorded means the record does not include a system message value.

  5. Do not treat either badge as proof that every field updated successfully. Open the product from the Product workbench and compare Product details with the expected change.

  6. If the expected shop update is missing or the product remains stale, record the product ID, shop, displayed timestamp, and system message, when present, for your OMS administrator or HotWax Support.

Outcome: You can distinguish a missing recent shop snapshot from a product that remains stale after a snapshot appears, and you have the evidence needed for escalation.

Recent Recorded product update rows from the demo OMS
Compare recent product update records

Goal: Confirm that you are working in the intended OMS and product store, then rule out search filters before escalating stale or unavailable search data.

Use this flow when: Category or price edits may have used the wrong store context, Product workbench results are empty, or recently saved data does not appear in search.

Key labels: Settings, OMS instance, Go to OMS, Product Store, Select store, Product workbench, All types, All stores, All products, Could not load products, Retry.

  1. Open Products > Settings.

  2. Confirm OMS instance. Use Go to OMS if you need to verify the connected OMS directly.

  3. Under Product Store, use Select store to choose the store context required for category and price edits.

  4. Return to Product workbench. Clear the search and tags, then select All types, All stores, and All products to rule out hidden filters.

  5. If the page shows Could not load products, select Retry.

  6. For a shop-originated update, compare the latest matching record in Imports with Product details and the Product workbench. For a change made in Product details, reload Product details and the Product workbench.

  7. If the inconsistency remains, send the collected product and update details to your OMS administrator or HotWax Support for search-index recovery.

The Products app does not provide search-index status or a manual index rebuild action. The Product Store in Settings also does not change the Product store filter on the Product workbench.

Outcome: You have confirmed the OMS and store context, ruled out search filters and a retryable load error, or prepared a focused escalation for index recovery.

Products app settings showing the demo OMS instance and Demo Store
Confirm the OMS instance and current product store

7. Choose the product identifier shown on product rows

Goal: Show the identifiers your team recognizes, such as a SKU or UPC, on every product row in the app.

Use this flow when: Product rows lead with an identifier your team doesn't use, or show a product's name where you expected an identifier.

Key labels: Settings, Product identifier, Primary, Secondary, Preview product identifier, Shuffle.

The setting belongs to the Product Store selected in Settings and applies to everyone who uses that store. It's the same product identifier setting the other HotWax Commerce apps use. Changing it requires the COMMON_ADMIN permission.

  1. Open Products > Settings and confirm the Product Store.

  2. In Product identifier, choose the Primary and Secondary identifiers. Each choice shows how many products have it, for example UPCA (1,698 products) or GTIN (no products).

  3. Check Preview product identifier. It shows a product sampled from the catalog the way rows will show it. Select Shuffle to preview another product.

  4. The change saves when you choose it.

Product rows show the image, then the primary and secondary identifiers. This applies on the Product workbench, Missing values, the Product calendar and its dates dialog, the variant strip, product pickers, the Resolve duplicates dialog, and associated products.

A product without the primary identifier shows its name instead. When it has no name, it shows its internal name or product ID. The preview tells you when this happens, for example No UPCA on this product, so rows show its name.

By default rows show the SKU, then the product ID.

Outcome: Product rows across the app lead with the identifiers you chose.

8. Review and edit calendar dates for a product store

Open Product calendar to review and edit the Introduction, Launch, Support ends, and Sales ends dates for the store shown on that page. These store-specific dates are separate from the general product dates edited in Product details. You can edit one product's dates or many products' dates at once.

See Manage the product calendar for scope, search, editing, and mapping coverage.

Last updated

Was this helpful?