Ürün CSV sütunları: hangileri zorunlu, hangileri üzerine yazar
Önemli Shopify ürün CSV sütunları: zorunlu alanlar, varyant ID’lerini koruyan seçenek sütunları, üzerine yazma kutusu, metafield ve pazar sütunları.
- Zorunlu
- Title (yeni); URL handle + Title (güncelleme)
- Kodlama
- UTF-8, virgülle ayrılmış
- Boyut
- İçe aktarma dosyası başına 15 MB
- Nerede
- Products > Import / Export
- Son kontrol
Kısaca
Shopify ürün CSV’sinde yeni ürünler için yalnızca Title, güncellemelerde URL handle ve Title zorunludur. Tuzaklar şunlar: güncellemede Option1 name ve Option1 value sütunlarını çıkarmak mevcut varyantları siler, bir seçenek değerini değiştirmek yeni varyant ID’leri oluşturur, Overwrite products with matching handles işaretliyken boş hücreler veriyi temizler. Ürün metafield’ları Fabric (product.metafields.shopify.fabric) gibi başlıklar kullanır. Dosya UTF-8 ve en fazla 15 MB olmalıdır.
Nasıl kullanılır
- Güncel sütun adlarıyla başlamak için değiştireceğiniz ürünleri dışa aktarın (ya da Shopify’ın örnek CSV’sini indirin).
- Değiştirmeyeceğiniz sütunları silin ama varyant verisine dokunduğunuzda URL handle, Title, Option1 name ve Option1 value sütunlarını mutlaka bırakın.
- Google Sheets ya da başka bir tablo programında düzenleyip UTF-8 CSV olarak dışa aktarın.
- Overwrite products with matching handles kutusunu yalnızca boş hücrelerin değerleri temizlemesini istiyorsanız işaretleyin; içe aktardıktan sonra birkaç ürünü kontrol edin.
Kod
columns.txt# Required
New products: Title (plus URL handle when you add variants)
Updating: URL handle and Title
# Variant columns depend on the option columns
Changing SKU, Price, Weight value (grams) ... needs Option1 name and Option1 value.
Leaving out Option1 name/value on update creates a new default variant and DELETES existing variants.
Changing an Option value creates new variant IDs (breaks links and apps that store IDs).
# Overwrite products with matching handles (import checkbox)
Checked: blank cells in included columns overwrite existing values with blank
Unchecked: products whose handle already exists are skipped
# Useful columns
Status active | draft | archived
Published on online store true | false
Tags comma-separated inside one cell, max 250 per product
Barcodes up to 20, separated by ; (gtin:..., upc:...)
Weight value (grams) whole grams: 5.125 kg -> 5125
SEO title / SEO description up to 70 / 320 characters
Product metafields Name (product.metafields.<namespace>.<key>) or product.metafields.<namespace>.<key>
Markets Included / <Market>, Price / <Market>, Compare At Price / <Market>
# Not in the product CSV
Variant metafields (use the variant bulk editor)
Inventory per location (use the inventory CSV)
# File rules
UTF-8, comma-separated, first row = headers, 15 MB max per import file
products-minimal.csvTitle,URL handle,Option1 name,Option1 value,SKU,Price,Status
Rain Jacket,rain-jacket,Size,S,RJ-S,129.00,active
Rain Jacket,rain-jacket,Size,M,RJ-M,129.00,active
Rain Jacket,rain-jacket,Size,L,RJ-L,129.00,active
products-update-metafield.csvTitle,URL handle,Fabric (product.metafields.shopify.fabric),SEO title
Rain Jacket,rain-jacket,recycled-polyester,Rain Jacket in recycled polyester
Lintel tarafından yazıldı. MIT lisansı: kendi mağazanızda da müşteri işlerinizde de ücretsiz kullanabilirsiniz.
Sınırlar ve özel durumlar
- Varyant metafield’ları ürün CSV’sinde desteklenmez; varyant toplu düzenleyicisini kullanın.
- Ürün CSV’sindeki Inventory quantity yalnızca tek lokasyonlu mağazalar içindir; birden fazla lokasyon için stok CSV’sini kullanın.
- Option değerlerini değiştirmek yeni varyant ID’leri oluşturur; bu da sepet permalink’lerini, reklam feed’lerini ve eski ID’leri saklayan uygulamaları bozar.
- Dışa aktarımlar, aktif kataloglarından tam olarak biri başka bir pazarla paylaşılmayan pazarlar için Included / Price / Compare At Price sütunları ekler.
Sık sorulan sorular
- Shopify ürün CSV’sinde hangi sütunlar zorunlu?
- Yeni ürünlerde yalnızca Title. Ürün güncellerken URL handle ve Title. Varyant verisini değiştirdiğinizde Option1 name ve Option1 value da ekleyin.
- CSV içe aktarımı neden varyantlarımı sildi?
- Dosya, Option1 name ve Option1 value olmadan varyant sütunlarını güncelledi; Shopify da varsayılan bir varyant oluşturup mevcutları kaldırdı.
- Metafield’lar CSV ile nasıl içe aktarılır?
- Önce metafield’ı tanımlayın, sonra Fabric (product.metafields.shopify.fabric) ya da yalnızca product.metafields.shopify.fabric gibi bir başlık kullanın.
- “Overwrite products with matching handles” ne yapar?
- Handle’ı mevcut olan satırlar o ürünü günceller; dahil edilen sütunlardaki boş hücreler değeri temizler. İşaretli değilse mevcut handle’lar atlanır.
Shopify belgeleri
- Gösterilen tarihte bir Shopify mağazasında denendi. Shopify yönetim panelini sık değiştirir; bir adım farklı görünüyorsa fikir genellikle hâlâ geçerlidir.
- Örneklerde yer tutucu ID’ler ve your-store.myshopify.com kullanılır. Kendi değerlerinizle değiştirin.
- Kod parçaları MIT lisanslıdır.
Mağazanız için kurulmasını, test edilmesini ve bakımını isterseniz: Shopify geliştirme.
