WooCommerce Varyasyonlu Ürün CSV Import Rehberi

WooCommerce varyasyonlu ürün CSV import işlemi için tek bir dosyada ana ürün satırı (variable) ve alt varyasyon satırları (variation) hiyerarşik olarak tanımlanmalıdır. Alt satırlarda “Parent” sütununa ana ürünün stok kodu (SKU) veya kimliği girilir, “Type” alanına “variation” yazılır ve ilgili nitelik değerleri (beden, renk) eşlenerek içe aktarılır.

E-ticaret sitelerinde beden, renk, materyal gibi seçeneklere sahip ürünleri tek tek elle eklemek ciddi bir zaman kaybıdır. WooCommerce dahili CSV içe aktarıcısı bu işlemi saniyeler içinde tamamlamanıza imkan verir. Ancak basit ürünlerin aksine varyasyonlu ürünlerde doğru bir ebeveyn-çocuk (parent-child) ilişkisi kurulması gerekir. Farklı kaynaklardan gelen ürün listelerini WooCommerce yapısına uyarlamak için Pazaryerleri Arasında Ürün Aktarma: Kapsamlı Rehber içeriğimize göz atabilir, şablon dönüşümlerini kolaylaştırabilirsiniz.

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

1. Varyasyonlu ürün CSV hiyerarşisini oluşturma

WooCommerce içe aktarma motoru, her bir varyasyonlu ürünü en az iki satırlık bir yapıda işler. İlk satır ana ürünü (ana konteyner), sonraki satırlar ise bu ana ürüne ait bağımsız varyasyonları temsil eder.

1. Ana ürün satırını açın ve Type sütununa variable yazın. Bu satır genel ürün adını, açıklamayı, kategorileri ve tüm varyasyonlarda geçerli olan nitelik listesini barındırır.
2. Ana ürüne benzersiz bir SKU tanımlayın (Örn: TSHIRT-01).
3. Alt varyasyon satırlarını ana satırın hemen altına ekleyin ve Type sütununa variation yazın.
4. Alt varyasyon satırlarının Parent sütununa, ana ürünün SKU değerini (TSHIRT-01) yazarak bağlantıyı kurun.
5. Her varyasyon satırına kendi özel stok kodunu tanımlayın (Örn: TSHIRT-01-S-BLK, TSHIRT-01-M-BLK).

2. Nitelik (Attribute) sütunlarını tanımlama

Varyasyonların çalışabilmesi için niteliklerin hem ana üründe hem de alt satırlarda doğru formatta belirtilmesi şarttır.

1. Ana ürün satırında Attribute 1 name sütununa niteliğin adını yazın (Örn: Beden).
2. Ana satırın Attribute 1 value(s) alanına tüm seçenekleri aralarına dikey çizgi (|) koyarak yazın (Örn: S, M, L, XL).
3. Ana satırda Attribute 1 visible ve Attribute 1 global sütunlarını 1 yapın. Varyasyon oluşturulabilmesi için Attribute 1 default ve varyant üretme iznini açan alanları eksiksiz bırakın.
4. Varyasyon satırlarında ise Attribute 1 name alanına yine Beden yazın; ancak Attribute 1 value(s) alanına sadece o satırın değerini tekil olarak girin (Örn: Sadece S).
5. İkinci bir nitelik varsa (Örn: Renk), aynı mantıkla Attribute 2 name ve Attribute 2 value(s) sütunlarını kullanarak yan sütunlara ekleyin.

Farklı platformlardan veya tedarikçi listelerinden gelen tabloları bu formata sokmak için Excel / CSV → WooCommerce aracını kullanarak sütunları tek tıkla eşleyebilirsiniz. Benzer şekilde mağazanı taşıyorsan Shopify’dan WooCommerce’e Ürün Taşıma rehberinden de yararlanabilirsin.

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

3. CSV dosyasını WooCommerce paneline aktarma

Tablonuzu hazırlayıp UTF-8 formatında CSV olarak kaydettikten sonra WordPress yönetim paneline geçiş yapın.

1. WordPress panelinde sol menüden Ürünler > Tüm Ürünler sekmesine gidin ve üst kısımdaki İçe Aktar butonuna tıklayın.
2. Dosya Seç butonunu kullanarak hazırladığınız CSV dosyasını yükleyin.
3. Eğer daha önce yüklenmiş ürünleri güncelliyorsanız Mevcut ürünleri güncelle kutucuğunu işaretleyin; ilk defa yüklüyorsanız bu kutucuğu boş bırakın.
4. Devam butonuna basarak sütun eşleme (mapping) ekranına geçin.
5. WooCommerce sütun başlıklarını otomatik olarak eşleştirir. Özellikle SKU, Parent, Type, Regular price, Stock ve Attribute alanlarının doğru WooCommerce alanlarıyla eşleştiğini kontrol edin.
6. Sayfanın en altındaki İçe aktarıcıyı çalıştır butonuna basın ve işlemin tamamlanmasını bekleyin.

Eğer pazar yerlerinden hazır veri çekiyorsanız, n11 → WooCommerce aktarım aracı veya doğrudan mağaza geçişleri için Shopify → WooCommerce dönüştürücü ile şablonunuzu optimize edebilirsiniz. Farklı bir platformdaki varyant yapısını anlamak isterseniz Shopify varyant ekleme CSV yöntemleri ve WooCommerce’den Shopify’a geçiş yazılarımızı inceleyebilirsiniz.

WooCommerce varyasyon CSV sütun yapısı ve teknik kuralları

Aşağıdaki tabloda standart bir varyasyonlu ürün dosyasında bulunması gereken temel sütunlar ve alabilecekleri değerler listelenmiştir:

Sütun Adı	Ana Ürün (Variable) Değeri	Varyasyon (Variation) Değeri	Açıklama / Kural
Type	variable	variation	Ürün tipini belirler; yazım hatası olmamalıdır.
SKU	ANA-STOK-KODU	VARYANT-STOK-KODU	Her satırda benzersiz bir stok kodu olmalıdır.
Name	Ürün Başlığı	Ürün Başlığı - Varyant Adı	Ana ürünün adı vitrinde, varyant adı panelde görünür.
Parent	(Boş bırakılır)	ANA-STOK-KODU	Varyasyonun bağlı olduğu ana ürünün SKU değeridir.
Regular price	(Genellikle boş)	250.00	Fiyatlar nokta (.) ayracı ile yazılmalıdır.
Stock	(Boş veya toplam)	15	Her varyantın kendi fiziksel stok adedidir.
Attribute 1 name	Beden	Beden	Niteliğin sistemdeki adı (birebir aynı olmalı).
Attribute 1 value(s)	S, M, L, XL	S	Ana üründe tüm liste, varyasyonda tek değer girilir.
Attribute 1 visible	1	0 veya boş	Ana üründe niteliğin sayfada görünmesini sağlar.
Attribute 1 global	1	1	Global (ortak) nitelik kullanımı için 1 verilir.

Sık yapılan hatalar

• Parent SKU değerinin hatalı girilmesi veya boş bırakılması: Alt varyasyon satırında Parent alanı doldurulmazsa WooCommerce bu satırı bağımsız bir ürün sanar; ana ürün altında varyant seçenekleri çıkmaz; çözüm olarak varyasyon satırındaki Parent sütununa ana ürünün SKU kodunu birebir kopyalayın.
• Nitelik (Attribute) isimlerinde harf ve boşluk uyuşmazlığı: Ana üründe Beden, varyasyon satırında beden (boşluklu) yazıldığında sistem iki ayrı nitelik algılar; varyasyon menüsü bozulur veya boş gelir; çözüm olarak tüm satırlarda nitelik isimlerinin harf büyüklüğü ve boşluklarını aynı tutun.
• Noktalı virgül veya virgül ayracı karmaşası: CSV dosyasında ondalık basamak için virgül, liste ayrımı için noktalı virgül kullanıldığında WooCommerce sütunları kaydırabilir; fiyatları 199.90 formatında nokta ile, nitelik listelerini ise dikey çizgi (|) veya virgül ile standartlaştırın.
• Fiyatın sadece ana ürüne girilip varyasyonların boş bırakılması: Ana ürüne fiyat girilip varyasyonların fiyatı boş bırakılırsa sitede varyant seçildiğinde “Bu ürün mevcut değil” hatası alınır; her bir variation satırına mutlaka geçerli bir Regular price tanımlayın.
• Karakter kodlamasının ANSI olarak kaydedilmesi: Türkçe karakterler (ç, ğ, ı, ö, ş, ü) bozuk sembollere dönüşür ve aramalarda ürün bulunamaz; CSV dosyanızı her zaman UTF-8 (BOM’suz veya BOM’lu UTF-8) formatında dışa aktarın.

Sık sorulan sorular

WooCommerce CSV ile varyasyonlu ürün yüklerken Parent SKU zorunlu mu? Evet, alt varyasyon satırlarının hangi ana ürüne bağlı olduğunu WooCommerce’in anlayabilmesi için Parent sütununa ana ürünün SKU bilgisinin yazılması zorunludur. Bu alan boş bırakılırsa varyasyonlar ana ürüne bağlanamaz ve bağımsız taslak ürünler olarak sisteme girer.

CSV import sırasında global nitelikler (attributes) otomatik oluşturulur mu? Evet, CSV dosyanızdaki nitelik sütunları doğru adlandırılmışsa WooCommerce içe aktarma sırasında eksik nitelikleri ve terimleri otomatik olarak oluşturur. Ancak niteliklerin filtrelerde görünmesi için Attribute global sütununun 1 (doğru) olarak ayarlanması gerekir.

Büyük boyutlu CSV dosyalarında içe aktarma zaman aşımına uğrarsa ne yapılmalı? Zaman aşımı sorununu çözmek için CSV dosyasını 200-500 satırlık parçalara bölebilir veya sunucunuzun max_execution_time ve memory_limit değerlerini yükseltebilirsiniz. Parçalara bölerek yüklerken ana ürün satırının ve bağlı tüm varyasyonların aynı parça dosya içinde yer almasına dikkat etmelisiniz.

Mevcut varyasyonlu ürünleri CSV ile toplu olarak güncellemek mümkün mü? Evet, içe aktarma sihirbazında “Mevcut ürünleri güncelle” seçeneğini işaretleyerek SKU veya ID üzerinden mevcut varyasyonların fiyat ve stok bilgilerini güncelleyebilirsiniz. Bu işlem sırasında sadece güncellemek istediğiniz sütunları ve kimlik belirteçlerini (SKU/ID) içeren bir dosya kullanmanız yeterlidir.

Hızlı ve hatasız varyasyon aktarımı

WooCommerce üzerinde varyasyonlu ürün yönetimi, doğru CSV kurgusu uygulandığında dakikalar süren pratik bir işleme dönüşür. Dosya hiyerarşisinde variable ve variation satırlarını eksiksiz kurarak, Parent eşleşmelerini ve Attribute sütunlarını kontrol ederek sitenizi binlerce ürünle hızlıca doldurabilirsiniz. Karmaşık Excel listeleriyle vakit kaybetmeden tablolarınızı WooCommerce formatına getirmek için ücretsiz ve güvenli Excel / CSV → WooCommerce dönüştürücüsünü hemen kullanabilirsiniz.