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.
Open
Products>Product workbench.Search by product ID, SKU, UPC, or product name. The search runs when you pause typing.
Narrow the results with
Product type,Product store,Virtual/variant, orTags.If an expected product is missing, select
Clear filters. It clears the search and tags, and resets the other filters and the sort.Use the sort button in the list header to change the order:
Newest introduced(the default) orOldest introducedRecently updatedorLeast recently updatedProduct family, which lists each virtual product ahead of its variantsName A–Z,Name Z–A,SKU A–Z, orSKU Z–APrice: high to loworPrice: 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.
Check the list header, for example
25 of 1,986 matching products. More rows load as you scroll.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-orderorBack-orderbadges, tags, and 30-day sales.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
Find the products with the search and filters.
Select
Selectin the list header. In select mode, selecting a row selects it instead of opening the product.Select the rows to tag, or use the header checkbox to select every loaded row. The footer shows
{n} selected.Select
Add tagin the footer. Check the existing tags to add and selectAdd. To add a tag that doesn't exist yet, type it inSearch or enter new tagand selectAdd "<tag>".Wait while the app shows
Updating products.... It then reports how many products it tagged, or how many it couldn't tag.Select
Doneto 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.
Open the product from the Product workbench.
For a product family, use the feature options or variant strip to select the variant you want to inspect.
Select
Edit parentfor shared parent data orEdit variantfor data that belongs to the selected variant.Use the section that matches the task. For example, use
Displayfor the name, description, brand, or product type;Product identificationsfor SKU or UPC; andCategoriesorPricesfor store-specific setup.Complete the action for that section.
Display,Dates,Prices,Inventory policy, andShipping and handlinguse card-levelSaveandResetactions.Product identificationslists each identifier's type and value and uses an edit dialog (Edit).Tagsapply add or remove actions directly.CategoriesandShopify Shop Productsopen a dialog with its own save action.For sections with a
Savefooter, save each changed card. SelectResetto restore that card's editable fields. Staged substitute and component links have the additional behavior described below. If the app reportsUnderlying data changed, review the latest data before saving again.Use
Change historyto review recorded changes to identifier values and facility settings. Each entry names what changed, such asSKUorMinimum stock at Broadway, and how:Set to {value},Cleared, was {value}, or{from} to {to}, with when and who made it. SelectShow morefor older entries. UseImportsfor recent shop product update records.
Outcome: The app updates the intended parent or variant data, while card-level drafts remain separate.

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.
Open the product and select
Edit parentorEdit variant, depending on where the shipping data belongs.In
Shipping and handling, select aDefault box typewhen your shipping process requires one.Enter
Width,Height, andDepth, and confirm the unit beside each value. EnterWeightand confirm its unit.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.
Set
In shipping boxandCharge shippingas required by your shipping policy.Select
Save. SelectResetto restore the saved shipping draft instead.For a variant, select
Copy from parentwhen the parent already has the correct values. Review the copied draft, then selectSave; 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.

Link substitute products
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.
Open the product ID that appears on the order item. If orders contain a variant, select
Edit variantand configure that variant; downstream workflows do not fall back to a substitute link on its parent.In
Inventory policy, findSubstitutesand selectAdd.In
Add substitute, search byProduct ID, SKU, name, then select the approved replacement product.Select the checkmark button to return to
Inventory policy. Review the staged substitute and selectSaveon the card.Before saving, select
Expirebeside a staged substitute to remove it, or selectResetto clear all staged substitutes and restore the policy fields.For a saved link, select
Expirewhen the replacement is no longer approved. SelectReactivateto make an expired link active again.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.

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.
Create the kit product first if it does not already exist, then reopen it in
Product details.Select the
Edit parentorEdit variantcontext 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.In
Display, setTypetoMarketing Package: Pick Assembly. TheComponentsarea appears in the same card.Under
Components, selectAdd, then search for and select each component product.Set
Qtyto the number of component units required for one kit. For example, a component withQty2 requires six units for an order of three kits.Select the checkmark button. Review the staged components and quantities, then select
Saveon theDisplaycard. This saves the type change and creates the staged component links.Before saving, select
Expirebeside a staged component to remove it. For a saved component, useExpireorReactivateto 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.
Outcome: The pick-assembly kit has active component links with the quantity required for one kit.

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.
Confirm the current
Product StoreinSettings. The list shows that store's catalog categories.Open the product and select
Edit parentorEdit variant.In
Categories, selectEdit categories.Use
Search categoriesto filter by category name, description, or ID. The categories the product is in now start checked.Check the categories to add and uncheck the ones to remove. Selecting a row toggles its checkbox.
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.
Confirm the current
Product StoreinSettings.Open the product and select
Edit parentorEdit variant.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.For a variant, select
Copy from parentto 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.Select
Save, orResetto 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.
Link Shopify shop products
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 savedNot found on ShopifyInventory ID differs on Shopify
To fix a flagged link, select
Review Shopify valueswhen the row offers it. The edit dialog opens with the values Shopify has. Review them, then selectSave. Otherwise, selectEditand correct the IDs.To add a link, select
Add, then pick theShop: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 theShopify product IDand, if you have it, theShopify 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, selectUse Shopify'sto fill it in.
Select
Save.To change a link's IDs, select
Editon 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. SelectRemoveto remove a link; the app removes it at once, without a confirmation. On a verified link, selectOpen on Shopifyto 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.
Open
Products>Duplicate identifiers.Select
SKUto review duplicate SKUs across products, orUPCto review duplicate UPCs on variants.Open a duplicate group with
Resolve N products.Confirm each listed product, then replace the duplicate value with the correct unique SKU or UPC.
Select
Save N changes.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.

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.
Open
Products>Missing values.Review
Catalog coverage. The page orders the cards with the largest gaps first.Select
Image,Tags,Brand,UPC,SKU, orPrimary categoryto list the affected products.Open a product from the list.
Update the matching area in
Product details:Select the product image and update
Image URLfor a missing image.Use
Displayfor a missing brand.Use
Product identificationsfor a missing SKU or UPC.Use
Tagsfor a missing tag.Use
Categoriesto add the intended category whenPrimary categoryis missing. The app does not provide a control to designate a category as primary, so escalate the product ID if the gap remains.
Complete the section's save or add action. Return to
Missing valuesand 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.

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.
Open
Products>Importsand selectRefreshto load the latest records. The page shows the latest 100 records, not a complete event history.Search by product ID, parent product ID, displayed SKU, shop, or system message.
Compare the displayed timestamp and
Shopwith the change you expected.Read the badge as an update-record detail:
Syncedmeans the record includes aSystem messagevalue.Recordedmeans the record does not include a system message value.
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.
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.

6. Verify product store and recover product search
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.
Open
Products>Settings.Confirm
OMS instance. UseGo to OMSif you need to verify the connected OMS directly.Under
Product Store, useSelect storeto choose the store context required for category and price edits.Return to
Product workbench. Clear the search and tags, then selectAll types,All stores, andAll productsto rule out hidden filters.If the page shows
Could not load products, selectRetry.For a shop-originated update, compare the latest matching record in
Importswith Product details and the Product workbench. For a change made in Product details, reload Product details and the Product workbench.If the inconsistency remains, send the collected product and update details to your OMS administrator or HotWax Support for search-index recovery.
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.

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.
Open
Products>Settingsand confirm theProduct Store.In
Product identifier, choose thePrimaryandSecondaryidentifiers. Each choice shows how many products have it, for exampleUPCA (1,698 products)orGTIN (no products).Check
Preview product identifier. It shows a product sampled from the catalog the way rows will show it. SelectShuffleto preview another product.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.
Related guides
Last updated
Was this helpful?