WooCommerce Ürün Import CSV Nasıl Hazırlanır?

WooCommerce ürün import CSV dosyası hazırlamak için UTF-8 formatında bir elektronik tablo oluşturup Type, SKU, Name, Regular price, Images ve Stock gibi standart sütun başlıklarını eklemeniz gerekir. Varyantlı ürünlerde ana ürünü variable, alt seçenekleri variation tipiyle alt satırlara tanımlayıp dosyayı virgülle ayrılmış CSV olarak kaydederek içe aktarabilirsiniz.

E-ticaret sitenize yüzlerce veya binlerce ürünü tek tek elle girmek hem zaman kaybına yol açar hem de hata riskini artırır. WooCommerce’in yerleşik içe aktarma aracı, doğru yapılandırılmış bir CSV dosyasıyla tüm envanterinizi, kategorilerinizi, fiyatlarınızı ve varyantlarınızı dakikalar içinde mağazanıza yüklemenizi sağlar. Farklı satış kanallarındaki operasyonlarınızı tek merkezden yönetmek istiyorsanız Pazaryerleri Arasında Ürün Aktarma: Kapsamlı Rehber içeriğimizdeki temel aktarım prensiplerini de inceleyebilirsiniz.

Ü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ç

WooCommerce CSV dosyasının temel sütun yapısı

WooCommerce, içe aktarma sırasında belirli sütun adlarını otomatik olarak tanır. Kolon başlıklarını standart İngilizce terimlerle hazırlamak, eşleme adımında hata yapma ihtimalinizi ortadan kaldırır. Basit (simple) ve varyantlı (variable) ürünler için ihtiyaç duyacağınız temel sütunlar şunlardır:

1. Type (Tür): Ürünün basit (simple), varyantlı ana ürün (variable) veya alt seçenek (variation) olduğunu belirtir.
2. SKU (Stok Kodu): Her ürün ve varyasyon için benzersiz bir kimlik kodudur. Güncellemelerin doğru çalışması için zorunludur.
3. Name (Ürün Adı): Mağazanızda görünecek ürün başlığıdır.
4. Published (Yayın Durumu): Ürünün yayında olup olmayacağını belirler (1 yayında, 0 taslak).
5. Is featured? (Öne Çıkan): Ürünün vitrinde öne çıkarılıp çıkarılmayacağı (1 veya 0).
6. Visibility in catalog (Katalog Görünürlüğü): Ürünün arama ve katalogda görünme durumudur (visible, catalog, search, hidden).
7. Short description (Kısa Açıklama): Fiyatın yanında çıkan özet metin.
8. Description (Açıklama): Ürün detay sayfasında alt kısımda yer alan detaylı HTML veya düz metin açıklama.
9. Regular price (Normal Fiyat): Ürünün satış fiyatıdır. Ondalık ayırıcı olarak nokta kullanılmalıdır.
10. Sale price (İndirimli Fiyat): Kampanyalı satış fiyatıdır.
11. Categories (Kategoriler): Ürünün bağlı olduğu kategorilerdir. Hiyerarşik kategoriler Giyim > Erkek > Tişört şeklinde, birden fazla kategori ise virgül ile ayrılır.
12. Images (Görseller): Ürün fotoğraflarının doğrudan URL adresleridir. Birden fazla görsel arasına virgül konur.
13. In stock? (Stokta Var mı?): Stok durumunu gösterir (1 stokta var, 0 tükendi).
14. Stock (Stok Miktarı): Sayısal envanter adedi.

Adım adım WooCommerce import CSV hazırlama

1. Boş bir tablo oluşturun ve karakter kodlamasını ayarlayın

Kullandığınız elektronik tablo programında yeni bir çalışma sayfası açın. Dosyanızın Türkçe karakterleri (ç, ğ, ı, ö, ş, ü) ve para birimi sembollerini sorunsuz desteklemesi için UTF-8 formatında çalışmanız şarttır. Farklı platformlardaki formatları tanımak için Shopify Ürün CSV Formatı: Şablon ve Sütun Rehberi yazımızdaki sütun mantığına da göz atabilirsiniz.

2. Basit ürün satırlarını doldurun

Varyantı olmayan (beden, renk gibi seçenekleri bulunmayan) her bir ürün için tabloda tek bir satır oluşturun. Type sütununa simple yazın, SKU, Name, Regular price, Stock ve Categories sütunlarını eksiksiz girin.

3. Varyantlı ürün hiyerarşisini kurun

Varyantlı ürünlerde yapı iki aşamalıdır:

• Ana Ürün Satırı: Type değerine variable yazın. Bu satırda genel ürün adı, genel açıklama ve kategoriler yer alır. Fiyat ve stok girmeyin. Attribute 1 name sütununa özellik adını (örneğin Beden), Attribute 1 value(s) sütununa ise tüm seçenekleri aralarına dik çizgi koyarak yazın (örneğin S | M | L). Attribute 1 visible ve Attribute 1 global sütunlarına 1 değerini verin.
• Varyasyon Satırları: Ana ürünün hemen altına her bir seçenek için ayrı bir satır açın. Type değerine variation yazın. Parent sütununa ana ürünün SKU kodunu girin. Bu satırlara kendi özel SKU kodlarını, Regular price ve Stock değerlerini ekleyin. Attribute 1 name alanına Beden, Attribute 1 value(s) alanına ise sadece o satıra ait değeri (örneğin sadece S) yazın.

4. Görsel bağlantılarını ekleyin

Images sütununa yerleştireceğiniz bağlantıların internet üzerinden doğrudan erişilebilir (public) olması gerekir. Örneğin: https://siteadi.com/wp-content/uploads/2026/09/urun-1.jpg. İlk yazılan görsel öne çıkan görsel, sonrakiler ise ürün galerisi olarak içeri alınır.

Farklı bir pazaryerinden dışa aktardığınız dosyaları WooCommerce standardına dönüştürmek karmaşık satır ve varyant düzenlemeleri gerektirebilir. Bu süreci otomatikleştirmek için n11 → WooCommerce veya Shopify → WooCommerce araçlarımızı kullanarak dosyalarınızı tarayıcınızda doğrudan dönüştürebilirsiniz.

Ü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ç

5. Dosyayı CSV formatında dışa aktarın

Tablonuzu hazırladıktan sonra dosya türünü CSV UTF-8 (Virgülle Ayrılmış) (*.csv) olarak seçip kaydedin. Sütun ayırıcı olarak virgül (,) kullanıldığından emin olun.

6. WooCommerce içe aktarma sihirbazını çalıştırın

WordPress yönetim panelinize girin ve şu adımları izleyin:

1. Ürünler > Tüm Ürünler sekmesine gidin.
2. Sayfanın üst kısmındaki İçe Aktar (Import) butonuna tıklayın.
3. Hazırladığınız CSV dosyasını seçin.
4. Daha önce yüklenmiş ürünleri güncellemek istiyorsanız Mevcut ürünleri güncelle kutucuğunu işaretleyin.
5. Devam butonuna basarak sütun eşleme ekranına geçin.
6. Sütunlarınız WooCommerce alanlarıyla otomatik eşleştiyse kontrol edip İçe Aktarıcıyı Çalıştır düğmesine basın.

WooCommerce CSV teknik sütun tablosu

Sütun Adı	Veri Tipi	Zorunlu mu?	Örnek Değer	Açıklama
Type	Metin	Evet	simple, variable, variation	Ürün tipini belirler
SKU	Metin/Sayı	Evet (Önerilen)	TSH-BLK-01	Benzersiz stok kodu
Name	Metin	Evet (Ana ürün)	Klasik Pamuklu Tişört	Ürün başlığı
Published	Mantıksal	Hayır	1 veya 0	Yayın durumu (1: Aktif, 0: Taslak)
Regular price	Sayı	Evet	299.90	Satış fiyatı (Nokta ayırıcılı)
Categories	Metin	Hayır	Giyim > Erkek, Tişört	Kategori ağacı
Images	URL	Hayır	https://site.com/img1.jpg, https://site.com/img2.jpg	Virgülle ayrılmış görsel linkleri
Stock	Tam Sayı	Hayır	50	Envanter miktarı
Parent	Metin	Varyantta Evet	TSH-MAIN-01	Bağlı olduğu ana ürünün SKU kodu
Attribute 1 name	Metin	Varyantta Evet	Beden	Ürün özelliği başlığı
Attribute 1 value(s)	Metin	Varyantta Evet	S veya `S	M

Farklı platformlardaki veri modellerini incelemek için Hepsiburada Ürün Excel Şablonu Nasıl Doldurulur? başlıklı rehberimizdeki alan yapısıyla karşılaştırma yapabilirsiniz.

Sık yapılan hatalar

• Virgül yerine noktalı virgül ayırıcı kullanılması: Excel varsayılan olarak bölgesel ayarlara göre noktalı virgül (;) ile dışa aktarım yapabilir. → WooCommerce içe aktarma sihirbazı tüm sütunları tek bir sütun gibi algılar ve içe aktarma başarısız olur. → Dosyayı kaydederken UTF-8 virgülle ayrılmış CSV formatını seçin veya içe aktarma ekranında gelişmiş ayarlardan ayırıcıyı noktalı virgül olarak güncelleyin.
• Fiyatlarda ondalık ayırıcı olarak virgül kullanılması: Fiyat alanına 199,90 şeklinde veri girilmesi. → Sistem ondalık kısmı kesebilir ya da fiyatı 19990.00 gibi hatalı algılayabilir. → Tüm fiyat sütunlarında ondalık ayracı olarak yalnızca nokta (199.90) kullanın.
• Varyasyonlarda Parent SKU alanının boş bırakılması: Alt varyasyon satırlarına variation tipi verilip ana ürünün SKU kodunun yazılmaması. → WooCommerce bu satırları nereye bağlayacağını bilemez ve yetim ürün oluşturur ya da içe aktarmaz. → Her varyant satırının Parent hücresine ana ürünün SKU bilgisini birebir ekleyin.
• Görseller için geçersiz veya yerel dosya yolu kullanılması: Images sütununa C:/resimler/urun.jpg gibi bilgisayar dizini yazılması. → Görseller sunucuya çekilemez ve ürünler görsel olmadan yayına girer. → Görselleri internete açık genel bir URL (https://...) olarak girin.
• Dosya yapısındaki biçimlendirme sorunları: Boş satırlar veya çift tırnak işaretlerinin hatalı kullanımı. → Dosya okuma sırasında satır kaymaları oluşur. Detaylı kontroller için Ürün dosyasındaki 7 yaygın hata ve çözümleri rehberimizdeki adımları uygulayın.

Sık sorulan sorular

WooCommerce CSV içe aktarma sırasında Türkçe karakterler bozulursa ne yapılmalı? Dosyayı UTF-8 veya UTF-8 BOM kodlaması ile kaydetmeniz gerekir. Excel’de Farklı Kaydet menüsünden ‘CSV UTF-8 (Virgülle Ayrılmış)’ seçeneğini kullanarak bu sorunu hemen çözebilirsiniz.

Varyantlı ürünleri CSV ile tek seferde yüklemek mümkün mü? Evet, ana ürünü ‘variable’ ve varyasyonları ‘variation’ tipinde alt satırlara ekleyerek tek dosyada yükleyebilirsiniz. Her varyantın Parent alanına ana ürünün SKU bilgisini yazmanız ve özellik değerlerini eksiksiz tanımlamanız yeterlidir.

Ürün görsellerini bilgisayarımdan doğrudan CSV içine ekleyebilir miyim? Hayır, CSV dosyasına doğrudan yerel dosya yolu yazamazsınız; görsellerin doğrudan erişilebilir genel web URL adreslerini (https://…) eklemeniz gerekir. Görselleri önce WordPress Ortam Kütüphanesine veya bir sunucuya yükleyip bağlantılarını virgülle ayırarak Images sütununa girmelisiniz.

WooCommerce CSV içe aktarma işleminde ürün sayısı sınırı var mı? Hayır, WooCommerce sisteminde doğrudan bir ürün sayısı sınırı bulunmaz fakat sunucunuzun bellek ve işlem süresi limitleri devreye girer. Genellikle 500 ile 1000 satırlık parçalar halinde içe aktarmak sunucu zaman aşımı (timeout) hatalarını önler.

Sonuç

WooCommerce için ürün CSV dosyası hazırlarken en kritik unsurlar; standart sütun başlıklarını doğru kullanmak, varyant hiyerarşisini parent SKU ile kurmak ve dosya kodlamasını UTF-8 olarak ayarlamaktır. Elinizdeki mevcut Excel listelerini, pazaryeri çıktılarını veya tedarikçi tablolarını elle tek tek düzenlemek yerine Excel / CSV → WooCommerce aracımızla saniyeler içinde mağazanıza uyumlu şablona dönüştürebilirsiniz. Dosyanız tarayıcınızdan çıkmadan, tamamen güvenli ve ücretsiz bir şekilde işlenir.