# Ürün CSV sütunları: hangileri zorunlu, hangileri üzerine yazar

> Önemli Shopify ürün CSV sütunları: zorunlu alanlar, varyant ID’lerini koruyan seçenek sütunları, üzerine yazma kutusu, metafield ve pazar sütunları.

Sayfa: https://lintelagency.com/tr/kaynaklar/shopify-ipuclari/csv-ice-ve-disa-aktarma-sutunlari

## Kısaca

Shopify ürün CSV’sinde yeni ürünler için yalnızca Title, güncellemelerde URL handle ve Title zorunludur. Tuzaklar şunlar: güncellemede Option1 name ve Option1 value sütunlarını çıkarmak mevcut varyantları siler, bir seçenek değerini değiştirmek yeni varyant ID’leri oluşturur, Overwrite products with matching handles işaretliyken boş hücreler veriyi temizler. Ürün metafield’ları Fabric (product.metafields.shopify.fabric) gibi başlıklar kullanır. Dosya UTF-8 ve en fazla 15 MB olmalıdır.

## Bilgiler

- **Zorunlu:** Title (yeni); URL handle + Title (güncelleme)
- **Kodlama:** UTF-8, virgülle ayrılmış
- **Boyut:** İçe aktarma dosyası başına 15 MB
- **Nerede:** Products > Import / Export
- **Son kontrol:** 2 Kasım 2026

## Nasıl kullanılır

1. Güncel sütun adlarıyla başlamak için değiştireceğiniz ürünleri dışa aktarın (ya da Shopify’ın örnek CSV’sini indirin).
2. Değiştirmeyeceğiniz sütunları silin ama varyant verisine dokunduğunuzda URL handle, Title, Option1 name ve Option1 value sütunlarını mutlaka bırakın.
3. Google Sheets ya da başka bir tablo programında düzenleyip UTF-8 CSV olarak dışa aktarın.
4. Overwrite products with matching handles kutusunu yalnızca boş hücrelerin değerleri temizlemesini istiyorsanız işaretleyin; içe aktardıktan sonra birkaç ürünü kontrol edin.

## Kod

### columns.txt

```text
# Required
New products:     Title (plus URL handle when you add variants)
Updating:         URL handle and Title

# Variant columns depend on the option columns
Changing SKU, Price, Weight value (grams) ... needs Option1 name and Option1 value.
Leaving out Option1 name/value on update creates a new default variant and DELETES existing variants.
Changing an Option value creates new variant IDs (breaks links and apps that store IDs).

# Overwrite products with matching handles (import checkbox)
Checked:   blank cells in included columns overwrite existing values with blank
Unchecked: products whose handle already exists are skipped

# Useful columns
Status                       active | draft | archived
Published on online store    true | false
Tags                         comma-separated inside one cell, max 250 per product
Barcodes                     up to 20, separated by ;  (gtin:..., upc:...)
Weight value (grams)         whole grams: 5.125 kg -> 5125
SEO title / SEO description  up to 70 / 320 characters
Product metafields           Name (product.metafields.<namespace>.<key>) or product.metafields.<namespace>.<key>
Markets                      Included / <Market>, Price / <Market>, Compare At Price / <Market>

# Not in the product CSV
Variant metafields (use the variant bulk editor)
Inventory per location (use the inventory CSV)

# File rules
UTF-8, comma-separated, first row = headers, 15 MB max per import file
```

### products-minimal.csv

```csv
Title,URL handle,Option1 name,Option1 value,SKU,Price,Status
Rain Jacket,rain-jacket,Size,S,RJ-S,129.00,active
Rain Jacket,rain-jacket,Size,M,RJ-M,129.00,active
Rain Jacket,rain-jacket,Size,L,RJ-L,129.00,active
```

### products-update-metafield.csv

```csv
Title,URL handle,Fabric (product.metafields.shopify.fabric),SEO title
Rain Jacket,rain-jacket,recycled-polyester,Rain Jacket in recycled polyester
```

## Sınırlar ve özel durumlar

- Varyant metafield’ları ürün CSV’sinde desteklenmez; varyant toplu düzenleyicisini kullanın.
- Ürün CSV’sindeki Inventory quantity yalnızca tek lokasyonlu mağazalar içindir; birden fazla lokasyon için stok CSV’sini kullanın.
- Option değerlerini değiştirmek yeni varyant ID’leri oluşturur; bu da sepet permalink’lerini, reklam feed’lerini ve eski ID’leri saklayan uygulamaları bozar.
- Dışa aktarımlar, aktif kataloglarından tam olarak biri başka bir pazarla paylaşılmayan pazarlar için Included / Price / Compare At Price sütunları ekler.

## Sorular

### Shopify ürün CSV’sinde hangi sütunlar zorunlu?

Yeni ürünlerde yalnızca Title. Ürün güncellerken URL handle ve Title. Varyant verisini değiştirdiğinizde Option1 name ve Option1 value da ekleyin.

### CSV içe aktarımı neden varyantlarımı sildi?

Dosya, Option1 name ve Option1 value olmadan varyant sütunlarını güncelledi; Shopify da varsayılan bir varyant oluşturup mevcutları kaldırdı.

### Metafield’lar CSV ile nasıl içe aktarılır?

Önce metafield’ı tanımlayın, sonra Fabric (product.metafields.shopify.fabric) ya da yalnızca product.metafields.shopify.fabric gibi bir başlık kullanın.

### “Overwrite products with matching handles” ne yapar?

Handle’ı mevcut olan satırlar o ürünü günceller; dahil edilen sütunlardaki boş hücreler değeri temizler. İşaretli değilse mevcut handle’lar atlanır.

## Shopify belgeleri

- [Using CSV files for products](https://help.shopify.com/en/manual/products/import-export/using-csv)
- [Open or edit a CSV file](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/csv-files)

## İlgili içerikler

- [Toplu düzenleyicide varsayılan olarak görünmeyen sütunlar](https://lintelagency.com/tr/kaynaklar/shopify-ipuclari/toplu-duzenleyici-gizli-sutunlar)
- [Tüm ürünleri bulk operation ile dışa aktarma](https://lintelagency.com/tr/kaynaklar/graphql/tum-urunleri-toplu-disa-aktarma)
- [Staged upload ve bulkOperationRunMutation ile toplu içe aktarma](https://lintelagency.com/tr/kaynaklar/graphql/staged-upload-ile-toplu-ice-aktarma)
- [Shopify’a geçiş: neler bozulur, nasıl planlanır?](https://lintelagency.com/tr/blog/shopifya-tasirken-neler-bozulur)

Lisans: MIT. Kendi mağazanızda da müşteri işlerinizde de ücretsiz kullanabilirsiniz.