WooCommerce CSV Import Hata Veriyor Çözüm Rehberi

WooCommerce CSV içe aktarma hatası genellikle UTF-8 kodlama eksikliği, yanlış sütun başlıkları, sunucu zaman aşımı sınırları (max_execution_time) veya hatalı görsel bağlantılarından kaynaklanır. Sorunu çözmek için CSV dosyasını UTF-8 biçiminde kaydedin, satır sayısını 500-1000 aralığında bölün ve dosyadaki sütunları WooCommerce standart şablonuna göre düzenleyin.

E-ticaret sitenize toplu ürün eklerken veya başka bir altyapıdan geçiş yaparken içe aktarma aracının hata vermesi operasyonunuzu tamamen durdurabilir. “Dosya ayrıştırılamadı”, “Geçersiz dosya türü”, zaman aşımı (504 Gateway Timeout) veya Türkçe karakterlerin bozulması gibi problemler en sık karşılaşılan engellerdir. Aşağıdaki adımları sırasıyla uygulayarak içe aktarma sürecini sorunsuz şekilde tamamlayabilirsiniz.

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

CSV dosyasını WooCommerce standartlarına uygun hale getirme

1. Karakter Kodlamasını UTF-8 Olarak Ayarlayın
   Excel üzerinden hazırlanan dosyalar varsayılan olarak yerel ANSI kodlamasıyla kaydedilebilir. Bu durum “ı, ş, ğ, ü, ö, ç” gibi Türkçe harflerin bozulmasına ve WooCommerce ayrıştırıcısının hata vermesine yol açar. Dosyanızı Excel’de kaydederken dosya türü olarak mutlaka CSV UTF-8 (Virgülle ayrılmış) (*.csv) seçeneğini belirleyin. Dosyayı gelişmiş bir metin düzenleyicide açıp kodlamanın “UTF-8 without BOM” (BOM içermeyen UTF-8) olduğunu doğrulayın.

2. Ayırıcı (Delimiter) Uyuşmazlığını Giderin
   Türkçe işletim sistemlerinde Excel, CSV dosyalarını virgül (,) yerine noktalı virgül (;) ile ayırır. WooCommerce içe aktarma sihirbazının ilk ekranında yer alan “CSV Ayırıcı” alanına, dosyanızın kullandığı gerçek ayırıcı karakteri girmelisiniz. Dosyanızı Not Defteri ile açtığınızda sütunlar noktalı virgülle ayrılmışsa, WooCommerce ekranındaki alana da ; yazın.

3. Zorunlu Başlıkları ve Sütun Yapısını Doğrulayın
   WooCommerce, ürünleri tanımak için belirli sütun adlarına ihtiyaç duyar. Dosyanızda en azından Type (Tür), Name (İsim), SKU (Stok Kodu) ve Regular price (Normal fiyat) sütunlarının bulunduğundan emin olun. Başlıklarda çift tırnak veya gereksiz boşluk bırakmamaya özen gösterin. Hatalı sütunları tek tek düzeltmek yerine Excel / CSV → WooCommerce aracını kullanarak verilerinizi WooCommerce şablonuna otomatik olarak dönüştürebilirsiniz.

4. Görsel Bağlantılarını (Image URLs) Kontrol Edin
   Images sütunundaki URL’lerin doğrudan erişilebilir, genel kullanıma açık ve SSL (https://) protokolüyle çalıştığını teyit edin. Birden fazla görsel ekliyorsanız her bağlantı arasına virgül koyun. Bağlantılardan biri 404 hatası veriyorsa veya kaynak sunucu görsel indirmeyi engelliyorsa (hotlink koruması), içe aktarma işlemi o satırda takılır ve zaman aşımına uğrar.

5. Varyasyonlu Ürün İlişkilerini Yapılandırın
   Varyasyonlu ürün yüklüyorsanız, önce ana ürünün (variable) satırı gelmelidir. Hemen ardından gelen varyasyon satırlarının Type sütununa variation, Parent sütununa ise ana ürünün SKU veya ID değeri yazılmalıdır. Bu hiyerarşi kurulmadığında varyasyonlar bağımsız basit ürünler olarak yüklenir veya sistem hata vererek işlemi durdurur.

Sunucu limitlerini ve PHP yapılandırmasını artırma

Büyük boyutlu CSV dosyalarında içe aktarma işleminin yarıda kalması genellikle dosyanın bozukluğundan değil, sunucu kaynaklarının tükenmesinden kaynaklanır. WordPress ortamında toplu işlem yaparken aşağıdaki PHP yönergelerini yükseltmeniz gerekir:

1. Bellek Limitini Artırın (memory_limit)
   WordPress ana dizininde bulunan wp-config.php dosyasına define('WP_MEMORY_LIMIT', '256M'); satırını ekleyin. Sunucunuz izin veriyorsa php.ini dosyasından memory_limit = 512M yapılması tavsiye edilir.

2. Çalışma Süresini Uzatın (max_execution_time)
   WooCommerce her ürün satırında veritabanına kayıt yazar ve görselleri indirir. Bu işlem zaman aldığından max_execution_time değerini en az 300 (saniye) olarak ayarlayın. Bu ayarı cPanel’deki “MultiPHP INI Düzenleyicisi” üzerinden veya .htaccess dosyanıza php_value max_execution_time 300 satırını ekleyerek yapabilirsiniz.

3. Yükleme Boyutunu Yükseltin (upload_max_filesize ve post_max_size)
   CSV dosyanız 2 MB’tan büyükse sunucu yüklemeyi reddedebilir. upload_max_filesize = 64M ve post_max_size = 64M değerlerini tanımlayarak dosya boyutu engelini aşın.

Ü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 içe aktarma hata kodları ve teknik ayarlar

Aşağıdaki tabloda, içe aktarma sırasında en sık karşılaşılan teknik hatalar, bunların kök nedenleri ve çözüm için gereken standart değerler listelenmiştir:

Hata / Belirti	Olası Neden	Çözüm ve Önerilen Değer
Dosya türü geçersiz (MIME Type)	WordPress CSV uzantısını güvenlik nedeniyle reddediyor	wp-config.php dosyasına ALLOW_UNFILTERED_UPLOADS izni verin veya CSV dosyasını UTF-8 formatında yeniden dışa aktarın.
504 Gateway Timeout / Beyaz Ekran	PHP çalışma süresi veya bellek sınırı aşıldı	max_execution_time = 300 ve memory_limit = 256M (veya 512M) olarak güncelleyin; dosyayı parçalara bölün.
Karakter bozulması (ü, ÄŸ vb.)	ANSI veya ISO-8859 kodlaması kullanımı	Dosyayı “CSV UTF-8 (BOM’suz)” olarak kaydedin; içe aktarma ayırıcısını dosya yapısıyla eşleştirin.
Görseller içe aktarılamadı uyarısı	Hotlink koruması, 404 hatası veya SSL uyuşmazlığı	Resim URL’lerinin tarayıcıda doğrudan açıldığından emin olun; CDN veya kaynak sunucu engellerini kaldırın.
Varyasyonlar ana ürüne bağlanmıyor	Parent (Üst) SKU eksik veya yanlış tanımlanmış	Varyasyon satırlarında Parent alanına ana ürünün SKU’sunu yazın; ana ürünün Type alanını variable yapın.
Mükerrer (çift) ürün oluşması	SKU eşleşmesi olmadan tekrar yükleme yapılması	İlk adımda “Mevcut ürünleri güncelle” kutusunu işaretleyin ve SKU sütununu boş bırakmayın.

Farklı platformlardan WooCommerce’e ürün aktarırken karşılaşılan sorunlar

Farklı e-ticaret sitelerinden veya pazaryerlerinden ürün çekerken sütun yapıları standart WooCommerce şablonuna uymaz. Örneğin pazaryeri ihracat dosyalarında kategori hiyerarşisi > işareti yerine farklı ayraçlarla tanımlanabilir veya ürün açıklamaları ham HTML kodları barındırabilir. Kapsamlı geçiş süreçlerini planlamak için Pazaryerleri Arasında Ürün Aktarma: Kapsamlı Rehber içeriğimize göz atabilirsiniz.

Eğer mağazanızı başka bir platformdan taşıyorsanız sistemlerin CSV standartları arasındaki farklara dikkat etmelisiniz. Shopify üzerinden aktarım yapıyorsanız sütun yapısı farklılıkları için Shopify Ürün CSV Import Hataları ve Çözümleri yazımızdaki eşleme kurallarını inceleyebilir veya doğrudan Shopify → WooCommerce dönüştürücümüzden yararlanabilirsiniz. Aynı şekilde n11 mağazanızdaki verileri aktarırken n11 → WooCommerce aracını kullanarak kategori ve varyant eşleşmelerini hatasız yapabilirsiniz. Dönemsel fiyat düzenlemeleri sırasında CSV bozulmalarını önlemek için ise Pazaryeri Ürün Fiyatlarını Toplu Güncelleme: Excel Rehberi sayfasındaki adımları izleyebilirsiniz.

Sık yapılan hatalar

• Dosyayı standart .xlsx biçiminde yüklemeye çalışmak: WooCommerce yerleşik içe aktarıcısı Excel (.xlsx) dosyalarını doğrudan tanımaz → “Geçersiz dosya biçimi” hatası alınır → Dosyayı Excel’de “CSV UTF-8” formatında dışa aktararak yükleyin.
• Varyant satırlarına normal ürün gibi fiyat girmek ama ana ürünü tanımlamamak: Sistem varyantları bağımsız ürünler olarak algılar → Mağazada yüzlerce kopya ve eksik seçenekli ürün oluşur → Her varyant grubunun başına mutlaka variable türünde bir ana satır ekleyin ve alt satırlara bu ana ürünün SKU bilgisini bağlayın.
• Binlerce satırlık CSV dosyasını tek seferde yüklemek: Sunucu zaman aşımına uğrar veya bellek tükenir → İçe aktarma yarıda kalır, bazı ürünler mükerrer eklenirken bazıları hiç yüklenmez → Dosyayı 500-1000 ürünlük küçük parçalara bölerek sırayla yükleyin.
• Excel’de barkod veya SKU sütunundaki uzun sayıların bilimsel gösterime (1E+13) dönüşmesi: WooCommerce ürün kodlarını bozuk kaydeder → Pazaryeri veya stok senkronizasyonu çöker → Excel’de barkod sütununu içe aktarmadan önce “Metin” formatına çevirin.
• Görsel URL’lerinin sonuna gereksiz parametreler eklemek: WooCommerce görsel dosya uzantısını (.jpg, .png) ayrıştıramaz → Ürünler görsel olmadan içeri alınır → Bağlantılardaki soru işareti ve sonrasındaki izleme parametrelerini temizleyin.

Sık sorulan sorular

WooCommerce CSV yüklerken “Geçersiz dosya türü” hatası nasıl çözülür?
wp-config.php dosyasına geçici olarak dosya türü izin kodu ekleyerek veya bir MIME türü yönetimi eklentisi kullanarak bu hatayı çözebilirsiniz. WordPress güvenlik mekanizması, sunucu MIME türünü doğru tanımlayamadığında CSV uzantısını zararlı dosya sayarak engelleyebilir. İçe aktarma tamamlandıktan sonra eklediğiniz kodu güvenlik gerekçesiyle kaldırmanız tavsiye edilir.

İçe aktarma sırasında ürün görselleri neden yüklenmiyor?
Görsellerin içe aktarılmaması çoğunlukla kaynak sunucudaki hotlink koruması, geçersiz SSL sertifikası veya URL’nin doğrudan bir resim dosyasına (.jpg, .png) işaret etmemesinden kaynaklanır. WooCommerce, CSV dosyasındaki bağlantıyı kullanarak resmi sunucunuza indirmeye çalışır; bu işlem sırasında bağlantı zaman aşımına uğrarsa görsel atlanır. Resim URL’lerini tarayıcıda gizli sekmede açarak herkese açık olup olmadığını denetlemelisiniz.

CSV ile mevcut ürünlerin fiyat ve stoklarını güncellemek için ne yapılmalı?
İçe aktarma sihirbazının ilk adımında yer alan “Mevcut ürünleri güncelle” kutucuğunu işaretlemeniz ve CSV dosyasında SKU veya ID sütununu doldurmanız gerekir. Bu ayar aktif olduğunda sistem mükerrer ürün oluşturmaz, dosyadaki SKU ile eşleşen mevcut ürünün fiyat, stok veya açıklama gibi alanlarını günceller. SKU sütunu boş bırakılırsa sistem her satırı yeni bir ürün olarak algılar.

Büyük CSV dosyalarını yüklerken sunucunun zaman aşımına uğraması nasıl engellenir?
Sunucu yapılandırmasındaki max_execution_time değerini en az 300 saniyeye ve memory_limit değerini 256M veya 512M seviyesine çıkararak zaman aşımını engelleyebilirsiniz. Paylaşımlı sunucu ortamında bu limitleri artırma yetkiniz yoksa, dosyanızı 300-500 satırlık parçalara bölerek yüklemeniz gerekir. Ayrıca her işlem partisinde içe aktarılacak satır sayısını filtre kancalarıyla düşürebilirsiniz.

Sonuç

WooCommerce CSV içe aktarma hataları çoğunlukla dosya formatı, ayırıcı uyumsuzluğu veya sunucu parametrelerinin yetersizliğinden kaynaklanır. CSV dosyanızı UTF-8 olarak kaydettiğinizde, sunucu zaman aşımı sürelerini esnettiğinizde ve sütun başlıklarını WooCommerce standartlarına göre yapılandırdığınızda toplu ürün yükleme süreci pürüzsüz çalışır.

Karmaşık Excel tabloları, bozuk karakterler veya pazaryeri çıktılarıyla vakit kaybetmek istemiyorsanız, dosyalarınızı tarayıcınızdan çıkarmadan saniyeler içinde uyumlu WooCommerce şablonuna dönüştüren Excel / CSV → WooCommerce aracımızı ücretsiz ve güvenle kullanabilirsiniz.