Catalog Precheck
Panduan
V001

Shopify CSV “Validasi gagal: opsi tidak unik”: cara memperbaikinya

Cari dua baris varian dengan kombinasi nilai Option1–3 yang sama dalam satu pegangan produk. Jangan mengubah setiap pegangan yang berulang: varian dari satu produk biasanya membagikannya.

Definisi aturan

Varian di bawah satu handle mengulangi kombinasi opsi yang sama.

Kritis

Batas perbaikan otomatis: Aturan ini memerlukan tinjauan manual; data bisnis tidak diubah secara otomatis.

Jangan menciptakan nilai opsi baru
Jika CSV ini memperbarui produk yang sudah ada, mengubah nilai Opsi dapat membuat ID varian baru dan memengaruhi aplikasi yang bergantung padanya. Konfirmasikan varian yang diinginkan di toko Anda sebelum mengedit.

Arti kesalahannya

Shopify mengatakan file tersebut mungkin berisi opsi duplikat untuk satu produk, atau produk yang sama mungkin muncul di tempat lain di bawah pegangan yang sama. Bandingkan kombinasi opsi lengkap, bukan hanya satu sel Ukuran atau Warna. Pegangan berulang diharapkan terjadi pada baris varian asli.

Dua baris, satu nilai Ukuran

Kedua baris di bawah ini termasuk dalam tee pegangan dan ditetapkan ke kombinasi opsi Ukuran: M. Pada layar sempit, gulir blok kode ke samping untuk melihat semua kolom.

Tidak valid: kombinasi opsi duplikat
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

Aturan V001 menandai kedua baris bisnis. Nama Title dan Option1 yang kosong pada baris lanjutan tidak menjadikan M varian yang berbeda.

Koreksi ilustrasi: dua ukuran berbeda
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

Gunakan L hanya jika baris kedua benar-benar menggambarkan ukuran L. Jika tidak, hapus baris yang benar-benar duplikat atau perbaiki pemetaan produk setelah memeriksa data sumber.

Cara menyelidiki dengan aman

  1. 01

    Pertahankan CSV asli. Kelompokkan baris berdasarkan pegangan URL, lalu bandingkan setiap nilai Option1, Option2, dan Option3 yang tidak kosong dalam setiap produk.

  2. 02

    Periksa apakah baris berulang merupakan varian yang dimaksudkan berbeda, baris produk duplikat yang tidak disengaja, atau baris kelanjutan hanya gambar. Pegangan yang berulang saja bukanlah alasan untuk mengganti nama suatu produk.

  3. 03

    Perbaiki kesalahan sumber sebenarnya: berikan nilai opsi sebenarnya pada varian nyata, hapus hanya duplikat yang dikonfirmasi, atau gunakan pegangan yang benar jika itu milik produk lain.

  4. 04

    Jalankan kembali pemeriksaan lokal, tinjau temuan lainnya, dan verifikasi perubahan apa pun pada varian yang ada di Shopify sebelum mengimpor.

Temukan kombinasi duplikat secara lokal

Aturan Pra-pemeriksaan Katalog V001 melaporkan kombinasi Option1–3 yang tidak kosong berulang di bawah pegangan yang sama. Ini mengabaikan baris hanya gambar. Itu tidak dapat memutuskan baris mana yang benar atau melihat varian yang sudah ada di toko Anda. Pengembalian akan membuka validator baru; file yang dipilih sebelumnya tidak disimpan.
Periksa CSV sayaLihat aturan V001
Yang masih belum pasti
Pemindaian tingkat file yang bersih tidak membuktikan bahwa CSV cocok dengan varian Shopify yang ada atau bahwa impor akan berhasil. Tinjau ID produk dan varian yang dimaksud sebelum mengubah opsi pada produk yang sudah ada.

Sumber diperiksa: 28 September 2026. Shopify: masalah impor yang umum · Shopify: opsi produk CSV dan ID varian

Catalog Precheck adalah alat independen dan tidak berafiliasi dengan Shopify.