Import 1688 to Shopify: The Complete Guide

Bottom Line Up Front (BLUF): Cut 1688 import time by 91.2%. Manually importing a 50-SKU 1688 listing into Shopify takes 1–2 hours of saving images, renaming files, writing handles, and mapping variants. In a 2026 benchmark across 500 SKUs (Zi Dong Liang, EasyCatch Lab, August 2026), a manual import averaged 118.2 seconds per SKU with a 34.6% broken image link rate. EasyCatch runs the same import in 10.4 seconds with a 0.2% variant mismatch rate and exports SEO-ready handles, standardized JPG images, and a Matrixify-compatible CSV.

What are the key technical specifications for 1688 to Shopify importing?

Proprietary Benchmark (500 SKUs Tested)

In an empirical study conducted by Zi Dong Liang (EasyCatch Architecture Lab, August 2026) across 500 cross-category 1688 products, manual image collection produced a 34.6% broken-image rate (image links that failed to load after import), while manual variant alignment produced a separate 19.2% variant-name mismatch rate. With EasyCatch DOM sniffing, mismatch errors dropped to 0.2%, cutting average export time per 20-variant SKU from 118.2s to 10.4s (91.2% time reduction). The same study found 88.4% of 1688 stores scatter images across cbu01.alicdn.com and img.alicdn.com; naive regex scraping mis-grabs downscaled thumbnails 42.1% of the time, while local DOM sniffing resolves 100% of original-resolution images. Full testing methodology & dataset.

Why does manual 1688 CSV import fail so often?

Quick Answer: Manual 1688 CSV imports fail because variant options, image URLs, and category fields never match Shopify’s rigid CSV schema — an automated 1688-to-Shopify importer maps every field natively and cuts listing time by 91.2%.

Shopify merchants who source from 1688 face the same bottleneck: product data is rich, but it is not formatted for Shopify. You must extract titles, prices, SKUs, variants, descriptions, and images — then rebuild them inside Shopify’s rigid CSV schema. This guide starts once you already have a product to list. If you still need to vet the factory, pay the supplier, or check the margin, start with 1688 sourcing: suppliers, payment rails & landed cost.

Manual Sourcing vs. EasyCatch Automation: Step-by-Step Time Breakdown

The table below breaks down a real-world 50-SKU 1688 listing with 8 color/size variants and 36 gallery images. Timings were averaged across three sourcing runs by an experienced Shopify operator.

The biggest wins are in the repetitive, error-prone steps: image renaming, variant mapping, and CSV assembly. EasyCatch does not remove the final Shopify upload step entirely — you still control what goes live — but it removes the manual prep work that consumes 90%+ of sourcing time. For teams that want to wire captures into n8n, Make, or a local MCP server, the EasyCatch Developer Gateway exposes webhook and JSON-RPC endpoints.

What is the 4-step 1688-to-Shopify import workflow?

Step 1 — Link Your Shopify Store

Open your Shopify admin once. 0-Click Shopify CDN Auto-Sniffing reads your store’s CDN prefix in ~0.02 seconds, so every image URL generated later already points to the correct host. No copy-pasting cdn.shopify.com paths.

Step 2 — Auto-Generate the SEO Handle

1688 titles are often stuffed with keywords, model numbers, and promotional phrases. The Auto SEO Handle Generator strips the noise and produces a clean Shopify URL slug. For example, "2024 New Summer Women Dress Casual Solid Color V-Neck" becomes women-casual-v-neck-summer-dress.

Step 3 — Capture and Review the 1688 Page

Capture the product data that the Matrixify CSV is built from: title, price, SKU, variant options (color, size, material), description HTML, and the full gallery. Review the data before exporting, because every later CSV column is derived from it. The capture itself (sniffing the page, checking variants in the sidebar) is covered by the Chrome extension for 1688 walkthrough; this guide stays on the CSV and Matrixify side.

Step 4 — Export the Shopify-Ready ZIP

Hit Export. You receive a ZIP containing:

• A 57-column Matrixify-compatible CSV with pre-filled handles, variants, and image URLs.
• Standardized JPG images named {handle}-variant-{option}.jpg.
• A manifest file mapping each variant to its primary image.

Upload the images to Shopify Content > Files, then import the CSV into Matrixify. Because the URLs are pre-built and variant images are pre-matched to each SKU, Matrixify imports the entire catalog in one pass.

Need advanced automation or Webhook/MCP dispatches? Check the EasyCatch Developer Gateway.

How do you map 1688 data to Matrixify CSV columns?

Matrixify reads one row per variant. The parent product fields repeat on every row of the same Handle, and the variant fields change per row. This is the mapping EasyCatch writes into the export, and the one to keep if you edit the CSV by hand:

Import order that avoids Matrixify errors:

1. Upload the exported JPG images to Shopify Content > Files first, so every Image Src and Variant Image URL resolves.
2. In Matrixify, create a new import job and upload the CSV; Matrixify detects the Products sheet from the column headers.
3. Leave the default Command: MERGE for new products. Use REPLACE only if you intend to overwrite an existing Handle.
4. Run the import and open the Matrixify results file. A row reported as failed almost always points to a changed Option1 Name or a duplicate Handle.

What are common 1688 import errors and how do you fix them?

Even experienced Shopify merchants hit edge cases when moving 1688 data into Shopify. Below are the three most common failures, why they happen, and the fastest fix — most of which EasyCatch handles automatically. If you are scaling across several stores, also see our Multi-Store Shopify Sourcing Automation guide for workspace isolation and per-store CDN prefixes.

Image Download Failures

Symptom: Shopify shows a broken image icon, or Matrixify reports “Image URL unreachable” during import.

Root cause: 1688 serves images from lazy-loaded CDNs that block hot-linking, and some galleries use WebP or AVIF formats that Shopify’s native importer rejects. Manually saved files also carry Chinese-character filenames or supplier watermarks that break URL encoding.

Fix: EasyCatch downloads the full gallery locally, transpiles every image to JPG, and renames files to {handle}-variant-{option}.jpg. Upload the standardized files to Shopify Content > Files first, then import the CSV. The URLs in the CSV point to your own Shopify CDN, so hot-linking and format errors disappear.

Variant Option Name Mismatch

Symptom: Matrixify creates the product but variants collapse into one row, or the import fails with “Option1 Value missing.”

Root cause: 1688 uses inconsistent labels such as “Colour,” “Color,” “Size,” “尺码,” or “颜色分类.” Shopify requires exact Option1 Name / Option1 Value pairs across every variant row. A single mismatch breaks the entire product.

Fix: EasyCatch normalizes Chinese option labels into English Shopify equivalents during extraction. The exported CSV keeps Option1 Name identical for every variant of the same product, and every value maps to a pre-linked image URL. If you edit the CSV manually, never change the option column header mid-product.

Currency Conversion Rounding

Symptom: Variant prices appear off by one cent after import, or Shopify rounds 9.996 to 10.00 and breaks your margin.

Root cause: 1688 lists prices in CNY. Merchants often divide by the exchange rate in Excel, producing values with more than two decimal places. Shopify stores prices as cents/decimal with strict rounding, so 9.996 becomes 10.00 and 9.994 becomes 9.99.

Fix: Decide your final USD price before export and enter it as the target price in EasyCatch. The extension writes the exact value you specify into the Variant Price column, avoiding spreadsheet rounding drift. If you need bulk markup rules, apply them in Matrixify after the first clean import rather than inside the raw CSV. Before you lock in a price, model the full CNY → USD landed cost — shipping, duty, and payment fees included — with the free 1688 Landed Cost Calculator.

Duplicate Handle Collisions

Symptom: Matrixify overwrites an existing product instead of creating a new one.

Root cause: Shopify uses the Handle column as the unique product key. Two different 1688 listings with similar supplier titles can generate the same slug, such as summer-cotton-t-shirt.

Fix: Review the auto-generated handle in the EasyCatch sidebar before exporting. Add a distinguishing keyword — for example, summer-cotton-t-shirt-v-neck — so the handle is unique. EasyCatch highlights duplicate handles in the same capture session to catch collisions before they reach Shopify.

What is inside the EasyCatch export package?

Should you choose Free or Pro for 1688 imports?

The Free plan is ideal for testing the workflow with up to 5 captures per day. To scale, upgrade to Pro for unlimited captures, auto-handle generation, and Matrixify ZIP export. See the full comparison on our pricing page.

Compare plans

Which related guides should you read next?

• Before you import: vetting 1688 factories, paying suppliers, and pricing margin — The upstream decisions that come before any listing.
• One-click 1688 product capture in the browser — Sniff the 1688 page, check variants in the sidebar, and export the ZIP in about 10 seconds per SKU.
• 1688 Payment Methods for Foreigners — Alipay, Kuajingbao, sourcing agents and T/T compared for buyers without a Chinese bank card.
• EasyCatch vs DSers vs CJ Dropshipping — Honest comparison of pricing, CSV quality, fulfillment workflows, and automation depth for Shopify dropshippers.
• Shopify CDN Image Auto-Sniffing — How It Works — Technical breakdown of 0-Click CDN detection, image URL rewriting, and per-store prefix persistence.
• Multi-Store Shopify Sourcing Automation — Manage CDN prefixes and source products across multiple niche Shopify stores from one sidebar.
• Matrixify CSV & 1688 Variant Matching Guide — Deep dive into the 57-column CSV format, variant image pre-matching, and Shopify-native field mapping.
• How to Verify 1688 Suppliers & Negotiate Lower MOQs — Field-tested factory verification checklist and MOQ negotiation scripts for sourcing directly from 1688 with confidence.

Official references & further reading

• Shopify Help Center — Using CSV files to import and export products
• Shopify.dev — Product variant architecture

What are frequently asked questions about 1688 importing?

Can I import 1688 products to Shopify without an app?

Yes, but it is slow and error-prone. You would manually download images, write SEO handles, build a 57-column CSV, and map every variant. EasyCatch automates the entire workflow in one click.

Does EasyCatch support Shopify’s native CSV import?

EasyCatch exports a Matrixify-compatible 57-column CSV, which is a superset of Shopify’s native product CSV. You can import it directly via Matrixify or convert it to the native format.

What image formats does EasyCatch export?

EasyCatch transpiles 1688 WebP, AVIF, and HEIC images into standardized JPG files with SEO-friendly filenames such as {handle}-variant-{option}.jpg.

How much does the 1688-to-Shopify workflow cost?

The Free plan includes 5 captures per day. Pro unlocks unlimited captures, multi-store switching, and Matrixify ZIP export for $9.90/month. See our pricing page for details.

Why do my 1688 images show as broken links in Shopify?

1688 image CDNs often block hot-linking, and Shopify does not accept WebP/AVIF through the native CSV importer. The fix is to download images locally, convert them to JPG, and re-upload them to Shopify Content > Files. EasyCatch performs all three steps automatically and writes Shopify CDN URLs into the CSV so links stay valid.

How does EasyCatch handle Chinese variant labels like 颜色分类?

EasyCatch normalizes common 1688 option labels — including 颜色分类 and 尺码 — into Shopify-compatible English names such as Color and Size. The exported CSV keeps option names consistent across every variant row, which prevents Matrixify from collapsing variants or reporting missing option values.

Can I edit the exported CSV before importing into Shopify?

Yes. The Matrixify-compatible CSV is a standard text file you can open in Excel, Google Sheets, or LibreOffice. You can adjust titles, prices, tags, or descriptions. Just keep the Handle column unchanged for the parent product and keep Option1 Name identical across every variant row. If you change prices, enter the exact value you want Shopify to store to avoid rounding errors.

← Back to All Guides

Written by Zi Dong Liang

Founder & Lead Engineer, EasyCatch

Zi Dong Liang is the founder and lead engineer behind EasyCatch. With deep experience in browser extension architecture, e-commerce automation, and the Shopify ecosystem, he built EasyCatch to solve the most painful bottleneck in cross-border dropshipping: turning raw 1688 product pages into publish-ready Shopify listings. Before founding EasyCatch, he worked directly with Shopify merchants and sourcing agents, observing firsthand how teams lost hours to manual image renaming, CSV assembly, and variant mapping.

Learn more about EasyCatch and its founder →

Ready to import 1688 products in 10 seconds?

Get the free EasyCatch Chrome extension and export your first Matrixify-ready ZIP today.

Try EasyCatch 1688 Importer Free (10s Export)