Product Mappings let you manually connect Shopify products that were not created by SupplyMaster to a supplier's catalog. This is useful when you already have products in your store — with customized images, titles, or descriptions — and you want SupplyMaster to keep their inventory, pricing, or variant data in sync with a supplier without overwriting your customizations.
When to Use Product Mappings
You have branded or custom-designed products already in your Shopify store.
You've customized product images, names, or descriptions and want to preserve them.
You want SupplyMaster to update only inventory, pricing, or variant-level fields on these products.
Products imported directly by SupplyMaster are automatically linked to the supplier and do not need manual mapping.
Enabling the Product Mappings Editor
Navigate to Edit Supplier > Advanced Settings.
Set Product Mappings Editor to Enable Product Mapping Editor.
Click Save Supplier.
Once enabled, a Product Mappings tab appears on the supplier's product view page.
Adding a Product Mapping
Step 1: Map Products
Go to the Product Mappings tab and click + Add Mapping.
Select the Shopify product you want to link. You can search by product title.
Select the supplier product to link it to. This is the product from the supplier's catalog that matches your Shopify product.
Step 2: Map Variants
After selecting both products, you'll see a variant mapping table. Each row shows a Shopify variant (e.g., "Red / Medium") with a dropdown to select the corresponding supplier variant.
For each Shopify variant, select the matching supplier variant from the dropdown. Supplier variants are shown with their color, size, and ID to help you match correctly.
Each Shopify variant can only be linked to one unique supplier variant. If you try to map two Shopify variants to the same supplier variant, a warning icon will appear.
Select No Mapping (Preserve) for any Shopify variant you want to keep as-is, preventing supplier data from updating it during sync.
The status column shows your mapping progress:
Green check — Variant is mapped to a unique supplier variant.
Yellow warning — Variant is mapped but the supplier variant is used by another Shopify variant (duplicate).
Grey circle — Variant is not mapped or set to Preserve.
Step 3: Save
Click Save to confirm the mapping. The product will appear in the Product Mappings table showing the Shopify product, supplier product ID, number of variants mapped, and status.
Editing & Deleting Mappings
To edit a mapping, click the edit icon next to the product in the Product Mappings table. You can change variant assignments or switch the supplier product.
To delete a mapping, click the delete icon. This removes the link between the Shopify product and the supplier — the Shopify product itself is not deleted.
How Syncing Works with Mapped Products
Once a product is mapped, it participates in automatic syncs just like products created by SupplyMaster. The behavior depends on your Auto Sync Settings (configured in Edit Supplier > Automatic Sync):
Sync Behavior | What Happens |
Import Preserves | Fields are not changed during sync. Your customized data stays intact. |
Import Overwrites | Fields are replaced with supplier data on every sync. Custom titles, descriptions, or images may be overwritten. |
Import Adds | New variants found in the supplier catalog are created on the mapped Shopify product. |
To change these behaviors, go to Edit Supplier > Automatic Sync and adjust the Update Settings and Auto Create options.
Recommended Settings for Mapped Products
If you're using Product Mappings to keep customized products in sync, set your Update Settings to one of these options to protect your customizations:
Only Variant Fields — Updates pricing, inventory, weight, and variant attributes but leaves product-level fields (title, description, images) untouched.
Only Inventory — Updates only inventory quantities, preserving all other product and variant data.
Avoid using All Fields with Images or All Fields Except Images on mapped products unless you want the supplier data to fully replace your custom product content.
Tips
You don't need to map every variant. Use No Mapping (Preserve) for variants that you manage manually or that don't have a supplier equivalent.
Product Mappings are per-supplier. If you source the same product from multiple suppliers, each supplier mapping is independent.
Deleting a mapping does not delete the Shopify product — it only removes the supplier link. The product stays in your store.
After adding or changing mappings, run a manual sync or wait for the next automatic sync to see the updated data in Shopify.
Need Help?
If you get stuck at any point, contact support on chat in the bottom-right corner of the app.