Shopify Varyant Ekleme CSV: Adım Adım Toplu İçe Aktarma

Shopify’a CSV ile varyant eklemek için aynı ürüne ait her varyant satırında ‘Handle’ ve ‘Title’ sütunlarını birebir aynı tutmalı; ‘Option1 Name’, ‘Option1 Value’, SKU, fiyat ve stok sütunlarını her varyanta göre ayrı doldurmalısın. Hazırladığın UTF-8 kodlamalı CSV dosyasını Shopify panelindeki Ürünler > İçe Aktar ekranından yükleyebilirsin.

E-ticarette geniş bir ürün kataloğunu yönetirken ürünleri tek tek elle girmek zaman kaybına yol açar. Özellikle beden, renk, materyal gibi birden fazla varyasyonu olan ürünlerde Shopify’ın içe aktarma mekanizmasını doğru kavramak gerekir. Pazaryerlerinden veya tedarikçilerden aldığın listeleri mağazana taşırken varyant yapısını bozmamak için CSV dosyasındaki satır hiyerarşisini kusursuz kurmalısın. Farklı kanallardan ürün geçişi yapıyorsan Pazaryerleri Arasında Ürün Aktarma: Kapsamlı Rehber içeriğimize göz atarak genel mantığı pekiştirebilirsin.

Ücretsiz araçExcel / CSV → ShopifyExcel / CSV ürün dosyanı Shopify şablonuna çevirir; sütunlar eşlenir, barkod ve varyantlar korunur. Ücretsiz, kayıt yok, dosyan tarayıcından çıkmaz.Aracı aç

CSV ile varyant ekleme adımları

Shopify’da varyantlı ürün oluştururken sistem, satırları birleştirmek için Handle sütununu referans alır. Doğru bir dosya hazırlamak ve yüklemek için aşağıdaki adımları sırasıyla uygula.

1. Temel ürün satırını ve handle değerini belirle

Varyant grubunun ilk satırı, ana ürün bilgilerini taşır. Bu satırda Handle, Title, Body (HTML), Vendor, Type ve Tags gibi genel alanları eksiksiz doldur. Ürünün web adresini ve varyant gruplamasını belirleyen benzersiz kimliği doğru oluşturmak için Shopify Handle Nedir ve Nasıl Oluşturulur? başlıklı rehberimizden yararlanabilirsin. İlk satır aynı zamanda ürünün ilk varyantını temsil eder.

2. Varyant seçenek sütunlarını (Option Name ve Option Value) tanımla

Shopify standart yapısında en fazla 3 seçenek türü sunar. Ürünün niteliklerine göre sütun başlıklarını ve değerlerini yerleştir:

• İlk seçenek için Option1 Name alanına seçeneğin adını (ör. Beden), Option1 Value alanına ise varyantın değerini (ör. S) yaz.
• Renk varyantı da varsa Option2 Name sütununa Renk, Option2 Value sütununa Siyah yaz.
• Üçüncü bir nitelik varsa aynı mantığı Option3 Name ve Option3 Value için uygula.

3. Alt varyant satırlarını ekle ve ana bilgileri boş bırak

Aynı ürünün ikinci varyantı (örneğin M Beden - Siyah) için yeni bir satır aç. Bu satırda Handle değerini ilk satırla birebir aynı yap. Title, Body (HTML), Vendor, Tags gibi ana ürün sütunlarını boş bırak. Option1 Name ve Option2 Name başlıklarını yine aynı tutarak Option1 Value değerine M, Option2 Value değerine Siyah gir.

4. Varyant bazlı fiyat, SKU, barkod ve stok bilgilerini gir

Her satırın kendi varyantına ait operasyonel verilerini tanımla:

• Variant SKU: Her varyant için benzersiz stok kodu.
• Variant Barcode: Varsa GTIN, EAN veya barkod numarası.
• Variant Price: Satış fiyatı (ondalık ayracı olarak nokta kullan).
• Variant Compare At Price: İndirim öncesi liste fiyatı (opsiyonel).
• Variant Inventory Tracker: Stok takibi için shopify yaz.
• Variant Inventory Qty: İlgili varyantın başlangıç stok adedi.
• Variant Inventory Policy: Stok bitince satışı durdurmak için deny, ön sipariş için continue.

5. Varyant görsellerini URL olarak eşle

Her varyant satırında Variant Image sütununa o varyantın görsel URL adresini gir. Ana ürün galerisine ait diğer fotoğrafları eklemek istiyorsan, yine aynı Handle değerine sahip yeni bir satır açıp sadece Image Src sütununa görsel adresini yazabilirsin.

Ücretsiz araçExcel / CSV → ShopifyExcel / CSV ürün dosyanı Shopify şablonuna çevirir; sütunlar eşlenir, barkod ve varyantlar korunur. Ücretsiz, kayıt yok, dosyan tarayıcından çıkmaz.Aracı aç

Eğer elindeki liste hazır bir Excel tablosuysa ve Shopify sütunlarıyla tek tek uğraşmak istemiyorsan, Excel / CSV → Shopify dönüştürücümüzü kullanarak varyantlarını saniyeler içinde uyumlu formata getirebilirsin. Farklı kaynaklardan aktarım yapıyorsan Trendyol → Shopify ve WooCommerce’den Shopify’a Geçiş: Ürün Aktarımı süreçlerinde de aynı varyant mantığı geçerlidir.

6. Dosyayı UTF-8 formatında kaydet ve Shopify’a aktar

Tablonu CSV UTF-8 (Virgülle ayrılmış) formatında dışa aktar. Shopify yönetim panelinde Ürünler (Products) sekmesine gir, sağ üstteki İçe Aktar (Import) butonuna tıkla. Dosyanı seçtikten sonra “Mevcut ürünlerin üzerine yaz” (Overwrite) seçeneğini ihtiyacına göre işaretleyip önizlemeyi onayla.

Varyant CSV şablon yapısı ve sütun kuralları

Aşağıdaki tabloda, iki farklı varyantı bulunan tek bir ürünün CSV dosyasındaki satır hiyerarşisi ve kabul edilen veri standartları gösterilmektedir:

Sütun Adı (CSV Header)	1. Satır (Ana Ürün + İlk Varyant)	2. Satır (İkinci Varyant)	Zorunlu mu?	Açıklama
Handle	pamuklu-oversize-tisort	pamuklu-oversize-tisort	Evet	Satırları birleştiren benzersiz ürün kimliği.
Title	Pamuklu Oversize Tişört	(Boş bırakılır)	İlk satırda evet	Ürünün vitrindeki ana başlığı.
Body (HTML)	<p>Yüksek kaliteli tişört.</p>	(Boş bırakılır)	Hayır	Ürün açıklama metni.
Option1 Name	Beden	Beden	Evet	İlk seçenek türü adı.
Option1 Value	S	M	Evet	Seçenek değeri.
Option2 Name	Renk	Renk	Opsiyonel	Varsa ikinci seçenek türü.
Option2 Value	Siyah	Siyah	Opsiyonel	İkinci seçenek değeri.
Variant SKU	TSH-OVR-BLK-S	TSH-OVR-BLK-M	Önerilir	Varyanta özel benzersiz stok kodu.
Variant Price	450.00	450.00	Evet	Satış fiyatı (Nokta ayracıyla).
Variant Inventory Tracker	shopify	shopify	Hayır	Stok takibi yapılacaksa shopify.
Variant Inventory Qty	25	40	Hayır	Başlangıç stok adedi.
Variant Image	https://site.com/img/ts-s.jpg	https://site.com/img/ts-m.jpg	Hayır	Varyantın doğrudan görsel bağlantısı.

Sık yapılan hatalar

• Handle değerini varyant satırlarında farklı girmek: Varyantların tek bir ürün altında toplanması yerine her satırın bağımsız ayrı ürünler olarak açılmasına neden olur. Çözüm için bir ürüne ait tüm varyant satırlarında Handle hücresini harfi harfine aynı tutmalısın.
• Option Name sütunlarını alt satırlarda değiştirmek veya boş bırakmak: Shopify’ın varyant yapısını tanıyamamasına ve içe aktarmanın hata vermesine yol açar. Çözüm olarak ilk satırda Beden yazdıysan alt satırlardaki Option1 Name alanına da Beden yazmalısın.
• Fiyatlarda ondalık ayracı olarak virgül kullanmak: Fiyatın yanlış okunmasına veya satırın bölünmesine neden olur. Çözüm için CSV dosyasındaki tüm parasal değerlerde kuruş ayracı olarak nokta (450.00) kullanmalısın.
• UTF-8 kodlaması seçmeden CSV kaydetmek: Türkçe karakterlerin (ş, ı, ğ, ç, ö, ü) bozuk görünmesine yol açar. Çözüm için dosyayı Excel veya Google Sheets üzerinden dışa aktarırken CSV UTF-8 standardını tercih etmelisin.
• 100 varyant limitini aşmak: Shopify’ın ürün başına koyduğu 100 varyant sınırını aşan satırlar yüklenemez ve hata raporu üretir. Çözüm için 100’den fazla varyasyonu olan ürünleri farklı renk veya model seçenekleriyle ayrı Handle değerlerine bölmelisin.

Sık sorulan sorular

Shopify tek bir üründe CSV ile en fazla kaç varyant destekler? Shopify, tek bir ürün başına en fazla 100 varyant ve 3 seçenek kombinasyonuna (örneğin Beden, Renk, Materyal) izin verir. Bu sınır standart CSV yüklemelerinde de geçerlidir ve 100 varyantı aşan satırlar içe aktarma sırasında hata verir.

İkinci ve üçüncü varyant satırlarında ürün açıklaması (Body HTML) doldurulmalı mı? Hayır, ana ürün dışındaki varyant satırlarında Body (HTML) sütununu boş bırakmalısın. Açıklama metninin alt satırlarda tekrarlanması bazı içe aktarma senaryolarında veri çakışmasına veya gereksiz dosya şişmesine yol açar.

Farklı varyantlara ait görselleri CSV üzerinden nasıl bağlayabilirim? İlgili varyant satırındaki ‘Variant Image’ sütununa doğrudan o varyanta ait görselin tam web bağlantısını (URL) yazmalısın. Görsellerin Shopify paneline başarıyla çekilmesi için bağlantıların herkese açık ve doğrudan görsel dosyasına (.jpg, .png) yönlendiriyor olması gerekir.

Excel’de hazırlanan CSV dosyasındaki Türkçe karakterler Shopify’da neden bozulur? Excel varsayılan olarak dosyayı ANSI veya yerel Windows kodlamasıyla kaydettiği için Türkçe karakterler bozulur. Sorunu çözmek için dosyayı Excel’den dışa aktarırken kayıt türü olarak mutlaka ‘CSV UTF-8 (Virgülle ayrılmış)’ seçmelisin.

Sonuç

Shopify’da CSV ile toplu varyant eklemek; doğru Handle hiyerarşisini kurduğunda, Option sütunlarını tutarlı yönettiğinde ve UTF-8 formatına dikkat ettiğinde son derece hızlı bir işlemdir. Karmaşık ürün listeleriyle uğraşırken sütun eşleme hatalarından kaçınmak için Excel / CSV → Shopify dönüştürücümüzü kullanabilir, hiçbir kurulum yapmadan dosyalarını saniyeler içinde Shopify’a hazır hale getirebilirsin.