Shopify Ürün CSV Formatı: Şablon ve Sütun Rehberi

Shopify ürün CSV formatı; ürün başlığı, varyant bilgileri, fiyat, barkod, stok adedi ve görsel bağlantılarını içeren, UTF-8 kodlamalı virgülle ayrılmış bir elektronik tablo standardıdır. Handle sütunu ana kimlik görevi görürken, varyantlar ve birden fazla görsel aynı handle altında alt satırlarda sıralanarak mağazaya toplu aktarılır.

E-ticaret mağazanı büyütürken yüzlerce veya binlerce ürünü tek tek panelden girmek saatler sürer. Shopify, ürünleri topluca içe aktarmak için katı kurallara bağlı bir CSV (Comma Separated Values) formatı kullanır. Dosyadaki tek bir sütun adı hatası veya kodlama uyumsuzluğu, içe aktarma işleminin durmasına yol açabilir. Farklı kanallardan veri taşırken genel akışı görmek için Pazaryerleri Arasında Ürün Aktarma: Kapsamlı Rehber içeriğimize göz atabilirsin.

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

Shopify ürün CSV formatı nasıl hazırlanır?

Shopify sistemine sorunsuz yükleme yapabilmek için dosyanın sütun yapısını, satır hiyerarşisini ve dosya kodlamasını adım adım doğru kurman gerekir.

1. UTF-8 kodlamalı boş bir şablon oluştur

Shopify yalnızca UTF-8 biçiminde kodlanmış CSV dosyalarını tam uyumlu şekilde işler. Excel veya Google E-Tablolar üzerinde yeni bir çalışma sayfası aç ve sütun başlıklarını Shopify’ın İngilizce standart başlıklarına göre ilk satıra yerleştir. Dosyayı dışa aktarırken her zaman “CSV UTF-8 (Virgülle ayrılmış)” seçeneğini kullan; aksi takdirde Türkçe karakterler bozulur.

2. Handle sütununu ve ana ürün bilgilerini tanımla

Handle, ürünün mağaza URL’sindeki kalıcı bağlantısıdır (slug). Her ürün için benzersiz bir Handle belirle (örneğin: deri-erkek-cuzdan-siyah). İlk satırda ürünün genel bilgilerini doldur:

• Title: Ürün adı.
• Body (HTML): Ürün açıklaması (HTML etiketleri içerebilir).
• Vendor: Marka veya üretici adı.
• Product Category: Shopify standart ürün kategorisi.
• Type: Ürün tipi (örneğin: Cüzdan).
• Tags: Virgülle ayrılmış etiketler (örneğin: deri, aksesuar, erkek).
• Published: Ürünün mağazada hemen yayına girmesi için TRUE, taslak kalması için FALSE.

3. Varyant seçeneklerini ve stok bilgilerini yapılandır

Ürünün beden, renk veya materyal gibi varyantları varsa, bu varyantlar Option1 Name, Option1 Value, Option2 Name, Option2 Value sütunlarıyla yönetilir. Tek varyantlı (örneğin yalnızca beden içeren) bir tişört için:

• Option1 Name: Beden
• Option1 Value: İlk satıra S, ikinci satıra M, üçüncü satıra L yazılır.
• Her varyant satırında Variant SKU, Variant Grams (ürün ağırlığı), Variant Inventory Tracker (shopify), Variant Qty (stok miktarı) ve Variant Price (satış fiyatı) alanları eksiksiz girilmelidir.

4. Çoklu varyant satırlarında ana verileri boş bırak

Aynı ürüne ait ikinci ve sonraki varyant satırlarında Handle sütunu mutlaka dolu olmalı ve ilk satırla birebir aynı yazılmalıdır. Ancak Title, Body (HTML), Vendor, Type ve Tags alanları ikinci varyanttan itibaren boş bırakılmalıdır. Bu sütunlar tekrar doldurulursa Shopify bunları yeni bir ürün gibi algılamaya çalışabilir ya da hata döndürebilir.

5. Ürün görsellerini satırlara ekle

Image Src sütununa ürünün genel erişime açık web bağlantısını (URL) ekle. Bir ürünün birden fazla görseli varsa, her görsel yeni bir satıra yazılır. Bu ek satırlarda yalnızca Handle, Image Src ve Image Position (1, 2, 3 gibi görsel sırası) doldurulur; varyant veya başlık sütunları boş bırakılır.

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

Farklı platformlardan gelen verilerini bu yapıya dönüştürmek karmaşık geliyorsa Excel / CSV → Shopify aracımızı kullanarak sütunları otomatik eşleyebilir, varyant ve barkod yapısını saniyeler içinde uyumlu hale getirebilirsin. Pazaryerlerinden doğrudan geçiş yapıyorsan Trendyol → Shopify veya n11 → Shopify araçları da benzer dönüşümü senin yerine tarayıcında gerçekleştirir.

Shopify CSV sütunları ve teknik gereksinimler

Aşağıdaki tabloda Shopify ürün CSV dosyasında en sık kullanılan temel sütunların teknik kuralları ve veri formatları listelenmiştir:

Sütun Adı (Header)	Zorunlu mu?	Açıklama ve Format	Örnek Değer
Handle	Evet	Ürünün benzersiz URL kimliği. Küçük harf, tireli.	pamuklu-tshirt-mavi
Title	İlk satırda Evet	Ürünün ana başlığı. Varyant satırlarında boş bırakılır.	Pamuklu Basic Tişört
Body (HTML)	Hayır	Zengin metin veya HTML ürün açıklaması.	<p>100% pamuklu kumaş.</p>
Vendor	Hayır	Ürün markası veya tedarikçi adı.	Moda Tekstil
Type	Hayır	Özel ürün kategorisi veya sınıfı.	Tişört
Tags	Hayır	Virgülle ayrılmış filtre etiketleri.	yazlık, unisex, pamuk
Published	Hayır	Satış kanalında görünürlük durumu (TRUE / FALSE).	TRUE
Option1 Name	Varyant varsa Evet	Birinci varyant başlığı.	Beden
Option1 Value	Varyant varsa Evet	Birinci varyant değeri.	M
Variant SKU	Hayır (Önerilir)	Varyanta özel benzersiz stok kodu.	TSH-BLU-M
Variant Grams	Hayır	Gram cinsinden tam sayı ağırlık.	250
Variant Inventory Tracker	Hayır	Stok takip mekanizması (shopify yazılmalıdır).	shopify
Variant Qty	Hayır	Başlangıç stok adedi.	50
Variant Price	Evet	Satış fiyatı (nokta ile ayrılmış ondalık).	299.90
Variant Compare At Price	Hayır	İndirim öncesi üstü çizili fiyat.	399.90
Variant Barcode	Hayır	Barkod, EAN, UPC veya GTIN numarası.	8680001234567
Image Src	Hayır	İnternette erişilebilir doğrudan görsel linki.	https://site.com/img/mavi-1.jpg
Image Position	Hayır	Görselin galerideki sırası (1, 2, 3…).	1

Sık yapılan hatalar

Shopify ürün listelerini CSV ile yüklerken en çok karşılaşılan sorunlar ve çözüm yolları:

• Handle sütununda boşluk veya Türkçe karakter bırakılması → Ürün URL’leri geçersiz karakterler nedeniyle bozulur veya varyantlar birbirinden bağımsız ayrı ürünler olarak açılır → Handle alanında yalnızca küçük Latin harfleri, rakamlar ve tire (-) işareti kullan.
• Varyant satırlarında Title ve Description sütunlarının tekrar edilmesi → Shopify sistemi varyantları ana ürünle birleştiremez, mükerrer ürün kayıtları veya aktarım hataları oluşur → İlk satırdan sonraki varyant satırlarında Title, Vendor ve Body alanlarını tamamen boş bırak.
• Image Src alanına yerel dosya yolu (C:/Gorseller/…) yazılması → Shopify sunucuları yerel bilgisayara erişemediği için ürünler görselsiz yüklenir → Görselleri doğrudan erişilebilen bir sunucuya ya da Shopify Dosyalar bölümüne yükleyip https://... bağlantısını yapıştır.
• CSV dosyasının UTF-8 yerine ANSI / Windows-1254 olarak kaydedilmesi → ‘ş’, ‘ı’, ‘ğ’, ‘ç’ gibi Türkçe karakterler ’?’ veya bozuk sembollere dönüşür → Dosyayı kaydederken veya dışa aktarırken kodlama biçimini kesinlikle “CSV UTF-8” olarak ayarla. Detaylı kontroller için ürün dosyasındaki 7 yaygın hata ve çözümleri rehberini inceleyebilirsin.
• Option1 Name alanının varyant satırlarında farklı yazılması → Shopify her farklı isim için yeni bir seçenek matrisi oluşturur ve 3 seçenek sınırını aşarak hata verir → Aynı ürünün tüm varyant satırlarında Option1 Name değerinin (örneğin: Beden) harfi harfine aynı olduğundan emin ol.

Sık sorulan sorular

Shopify CSV dosyasında Handle sütunu boş bırakılabilir mi? Hayır, Handle sütunu her satırda mutlaka dolu olmalıdır. Shopify aynı Handle değerine sahip satırları tek bir ürünün varyantları veya ek görselleri olarak birleştirir; bu alan boş kalırsa içe aktarma başarısız olur.

Shopify CSV dosyasına bilgisayarımdaki yerel görselleri ekleyebilir miyim? Hayır, CSV dosyasındaki Image Src sütununa yalnızca internet üzerinden doğrudan erişilebilen genel URL adresleri yazılabilir. Bilgisayarındaki dosyaları doğrudan satıra yazamazsın; görselleri önce Shopify Dosyalar (Files) bölümüne veya harici bir sunucuya yükleyip bağlantısını almalısın.

Shopify ürün CSV dosyasının boyutu ve ürün sınırı nedir? Shopify tek seferde en fazla 15 MB boyutundaki CSV dosyalarının içe aktarılmasına izin verir. Ürün sayısı açısından katı bir üst sınır olmasa da dosya boyutu 15 MB’ı aşıyorsa listenizi parçalara bölerek yüklemeniz gerekir.

Bir ürünün en fazla kaç varyantı olabilir? Shopify standart altyapısında bir ürün için en fazla 100 varyant ve 3 seçenek tanımlanabilir. Renk, Beden ve Materyal gibi 3 farklı seçenek kombinasyonunun toplam adedi 100 sınırını aşamaz.

Sonuç

Doğru kurgulanmış bir Shopify ürün CSV formatı, binlerce ürünü dakikalar içinde sorunsuz bir şekilde mağazana aktarmanı sağlar. Sütun başlıklarının harfiyen eşleşmesi, UTF-8 kodlaması ve Handle hiyerarşisine dikkat ettiğin sürece içe aktarma süreci hatasız tamamlanır. Farklı bir e-ticaret altyapısından veya yerel Excel tablolarından Shopify’a geçiş yapıyorsan, Trendyol Ürünlerini Shopify’a Aktarma: Adım Adım Rehber ve n11’den Shopify’a ürün taşıma adımlarını takip edebilir; İkas altyapısından geliyorsan İkas → Shopify aracımızla dosyalarını tarayıcından dışarı çıkarmadan dönüştürebilirsin.

Tüm elektronik tablolarını anında Shopify formatına çevirmek için Excel / CSV → Shopify dönüştürücüsünü hemen ücretsiz kullanabilirsin.