Back to Help Center
Help CenterProducts & Import

Why is a variant on the Unmapped page, and how do I link it?

5 min readUnmapped (sidebar), web dashboard

Unmapped Variants lists every active variant of an active product in the selected store that has no supplier link, and the fix is to link it. Click the Link variant icon on its row and the product page opens straight on the quantity step for that variant. Once the link is saved, the variant leaves the list and its orders from the last 30 days that were waiting are re-checked on their own; an older order is re-checked when you link it from its own order page.

Steps

  1. Pick the store in the top bar. Without one, the page reads "No Store Selected" and "Please select a store from the header to view unmapped variants."
  2. Click Unmapped Variants in the sidebar. The page has the same heading ("View all product variants that are not linked to any supplier product").
  3. Find the variant with the search box "Search variants by name, SKU, or product name...". It matches the variant name, the SKU and the product title.
Unmapped Variants page with the Unmapped sidebar item, the search box, the Price header and a row's Link variant icon marked
Unmapped lists the active variants of the store's active products that have no supplier link; search finds one, and the row's Link variant icon starts the link.
  1. Click the icon at the end of the row (tooltip Link variant). The product page opens on the Unlinked tab at Set qty per order (step 2 of 3) for that one variant.
Product page on the Unlinked tab at Set qty per order (step 2 of 3) for one variant, reached from Unmapped, with the step heading marked
The Link variant icon on Unmapped opens the product page straight on Set qty per order for that one variant.
  1. Type in Qty per order how many supplier units one sale of the variant buys. Leave it at 1 when the supplier item is already the whole pack.
  2. Click Continue.
  3. On Choose the supplier item (step 3 of 3), paste the supplier product link or product ID in Primary Supplier Link *. Leave Secondary Supplier Link empty; this screen does not save it.
  4. Click Fetch product. The toast "Product fetched successfully!" confirms it.
  5. Under Select Primary Variant *, click the supplier variant that matches yours.
  6. Under Shipping Options, click a shipping option.
  7. Click Link 1 variant.
  8. On the Link results panel ("Linked 1 of 1 variant."), click Done.
  9. Click Unmapped Variants in the sidebar. The variant is no longer listed. When nothing is left, the page reads "No unmapped variants found".
Unmapped Variants page with an empty list and the No unmapped variants found message marked
An empty Unmapped page means every active variant of the store's active products has a supplier link.

Good to know

  • A variant is listed when all three hold: its product is active in DS-Mate (draft, archived and pending-review products are left out), the variant itself is active (hidden or deleted variants are left out), and no active supplier link matches its variant or its SKU. A variant whose primary link was removed but whose backup took over is not listed, because it is still linked.
  • Each row shows Variant (image, name and options), Product, SKU, Price (for a store that sells in a currency other than US dollars or pounds, US dollars first with the amount in your store's currency in grey under it; the info icon shows the rate and its date), Options chips such as "Color: Blue", and Channel. Click Variant, Product or Price to sort.
  • Clicking a row opens the product page without starting a link. The link starts only from the Link variant icon.
  • The page has no filters, no checkboxes and no bulk action, so you link one variant at a time from here. To link several variants of one product in one go, open the product from Products instead (see the linking question below).
  • An order that contains an unlinked variant waits with the chip "Needs attention" (tooltip "This order needs you to fix something before we can fulfill it."), and the item reads "Not linked to supplier". When the missing link is the order's only problem, the order page's notice reads "This order isn't linked to a supplier product yet" with the steps "Click Link product next to the item below", "Paste the AliExpress product link and pick a variant" and "We'll link it and re-check the order automatically". You can link from there as well.
  • If the product was never imported into DS-Mate, or the variant is missing from DS-Mate's copy of the product, the order shows a different issue, and Unmapped cannot fix it.
  • Plan limit: linking obeys your plan's linked-variant limit (Free 200, Starter 2,000, Growth 10,000, counted for the owner's whole account). At the limit the Link variant icon on the product page is disabled. The icon on Unmapped Variants still opens the quantity step, but the link is refused: Link results lists the variant as failed, ending with the code "PLAN_LIMIT_REACHED".
  • When the list has rows, Rows per page: offers 10, 25 or 50. If the list fails to load, the page reads "Could not load unmapped variants." with Try again. If the variant was removed from the product meanwhile, the toast "That variant no longer exists on this product" appears.

On the Shopify app

The page is also titled Unmapped Variants, but the row button is a text button Link. It opens the product page on that variant, with the same steps as on the web dashboard: Set qty per order (step 2 of 3), then Choose the supplier item (step 3 of 3). A backup supplier is not part of those steps; add it afterwards with Add Secondary on the product page's Linked tab. Clicking a row, rather than its button, opens a variant detail dialog. Price, in the table and in that dialog, shows the same way as on the web dashboard: US dollars first, with the amount in your shop's currency in grey under it when the shop sells in a currency other than US dollars or pounds. Without a store, the page reads "No Store Connected" and "Unable to determine the current Shopify store."

Next articleWhen you reach your plan's product limit

Still have questions?

Our support team is ready to help. Reach out and we'll get back to you as soon as possible.