Product Listings
Link sales-channel variants to the correct warehouse products.
Link each to the whose inventory should fulfill it. Several sales-channel variants can share one internal product.
Viewing Product Listings
Open ShipOS → Products → Product Listings (opens the Cybership dashboard in a new tab). Each row shows the selling shop, the listing, and the product it links to; a red X marks a listing with no product. Search by listing name, SKU, or linked product name, filter by shop, or choose the Not Linked view to see only listings without a product. Open a listing to review its channel details and its Product Mapping.
A product's Product Listings tab shows every listing that sells from it.
Link a Variant
- Find an unlinked or incorrectly linked variant.
- Open its action menu, from the listing row or the Product Mapping card, and choose Change Product Link or Create and Link Product, as appropriate.
- For Change Product Link, search for the correct product, select it, and choose Confirm Selection.
- For a listing with no product, Create and Link Product creates a product from the listing's name, SKU, weight, and price, then links it right away. Add the new product's dimensions before receiving stock.
When a shop syncs, Cybership links each listing to the product with the same SKU, or to the product with the same title when the listing has no SKU. If nothing matches, the sync creates a new product from the listing. A channel that uses its own SKU for an item you already stock therefore creates a second product with no stock: relink the listing to the stocked product with Change Product Link, then delete the unused product. Check the result rather than assuming similarly named variants share inventory. When several products share a SKU, Cybership links the oldest one.
Link products before accepting new orders where possible. Existing order lines capture product information at import; correcting a listing does not necessarily repair earlier custom-product lines.
Product Listing Sync
The connected channel supplies listing details. Review its integration settings for product synchronization, inventory publishing, and location mapping:
Inventory shared by multiple listings comes from their linked product. Use Understanding Inventory to distinguish physical stock from Available. Do not assume that a manual platform adjustment updates warehouse stock.
Troubleshooting Product Listings
- Not linked: compare the SKU and product identity, check whether the product exists, then link the intended record manually.
- Inventory not publishing: check the link, enabled inventory sync, platform inventory tracking, warehouse mapping, and returned integration errors.
- Duplicate or recreated variants: review channel identifiers and existing orders before changing links or removing records.
- Order cannot enter picking: inspect the fulfillment order's product mapping, inventory, warehouse, and readiness issues. Custom products require a different fulfillment path.