Variant mismatch

Resolve errors where variants can’t be matched or updated as expected. This doc is most relevant for CSV import flows (coming soon / not yet generally available).

Symptom

• Rows fail due to missing or mismatched variant identifiers.

Likely causes

• Missing or incorrect variant IDs in CSV.
• Option values changed and now conflict (e.g., duplicate combinations).
• SKU/Barcode mismatches used to match the wrong variant.

Steps to fix

1. Export a sample including: product_id, variant_id, title, variant title (combined options), and SKU.
2. Verify the variant_id, variant title (option values), and SKU match the current store data.
3. If changing option values, ensure each combination remains unique.
4. Re-map or correct SKUs/barcodes if used for matching.
5. Re-run Preview and confirm sample rows pass validation.

Prevention

• Avoid changing multiple identifier fields at once. Batch changes logically.

What to send support

• The failing row(s), error message, and a fresh export of the affected products.

Next steps

• Use CSV basics → Troubleshooting to confirm headers and IDs.
• Re-export the Filters & search guide scope with product + variant IDs to ensure you’re editing the right variants.
• If the job partially succeeded, review Job history & rollback to isolate impacted rows before retrying.
• Need more help? Follow the Support & contact checklist with shop URL, job ID, screenshots, and the failing CSV rows.

Was this helpful?

Need more help? Visit the Support & contact checklist for what to include (shop URL, job ID, screenshots, CSV snippet), then email support@xyppy.com or open an issue at GitHub Issues.