Shopify Handle Nedir ve Nasıl Oluşturulur?

Shopify handle, her ürün, koleksiyon, sayfa ve blog yazısı için benzersiz bir URL tanımlayıcısıdır (slug). Türkçe karakter, boşluk ve özel simge barındırmayan küçük harfler ile tirelerden oluşur. CSV içe aktarımlarında aynı ürüne ait varyantları ve çoklu görselleri tek bir ürün altında gruplamak için Handle sütunu kullanı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ç

Shopify Handle mantığı ve kullanım alanları

Shopify altyapısında “Handle”, mağazandaki her bir kaynağın sistem içindeki kimlik kartıdır. Bir ürün eklediğinde Shopify bu ürün için iki temel amaçla handle oluşturur:

1. Kullanıcı Dostu URL Yapısı: Ürünün web adresinin son kısmını belirler. Örneğin “Oversize Pamuklu Tişört” başlıklı bir ürünün bağlantısı magazaniz.com/products/oversize-pamuklu-tisort şeklinde oluşur. Buradaki oversize-pamuklu-tisort metni doğrudan handle değeridir.
2. CSV ile Veri Eşleme ve Varyant Birleştirme: Mağazana toplu ürün aktarırken Shopify hangi varyantın (renk, beden vb.) hangi ana ürüne ait olduğunu ürün başlığından değil, Handle sütunundaki değerden anlar. Aynı handle değerine sahip tüm satırlar tek bir ürün kartı altında toplanır.

Eğer farklı pazaryerlerindeki mağazanı taşıyorsan veya Pazaryerleri Arasında Ürün Aktarma: Kapsamlı Rehber içeriğimizde anlattığımız gibi çok kanallı satış yapıyorsan, handle yapısını doğru kurgulamak içe aktarım hatalarının önüne geçer.

Shopify Handle nasıl oluşturulur: Adım adım rehber

Handle değerini hem tekil ürünler için Shopify paneli üzerinden hem de yüzlerce ürün için Excel/CSV tablolarında formüllerle oluşturabilirsin.

Yöntem 1: Shopify yönetim panelinde otomatik ve manuel oluşturma

1. Ürün başlığını gir: Shopify admin panelinde Ürünler > Ürün Ekle yolunu izle. Ürün başlığını (Title) yazdığın anda Shopify arka planda otomatik bir handle üretir.
2. Arama motoru listelemesini aç: Sayfanın en altına in ve Arama motoru listelemesi (Search engine listing) kutusundaki Düzenle bağlantısına tıkla.
3. URL ve tanıtıcı alanını güncelle: URL tanıtıcı (URL handle) kutusunda sistemin önerdiği metni görebilirsin. Dilersen buradaki metni SEO kurallarına uygun biçimde kısaltabilir veya anahtar kelime odaklı hale getirebilirsin.
4. Kaydet ve yönlendirmeyi kontrol et: Var olan bir ürünün handle değerini güncelliyorsan “Eski URL için yönlendirme oluştur” seçeneğini işaretleyerek Kaydet butonuna bas.

Yöntem 2: Excel ve Google E-Tablolar üzerinde formülle handle üretme

Toplu ürün yükleme yaparken elindeki ürün başlıklarını hızlıca handle formatına çevirmek için elektronik tablo formüllerinden yararlanabilirsin:

1. Türkçe karakterleri dönüştür: A sütununda ürün adın varsa (A2), formülle ç, ğ, ı, ö, ş, ü harflerini c, g, i, o, s, u karakterlerine dönüştür.
2. Küçük harfe çevir: Metnin tamamını küçük harfe indirgemek için formülün en dışına KÜÇÜKHARF (LOWER) fonksiyonunu ekle.
3. Boşlukları tireye dönüştür: YERİNEKOY (SUBSTITUTE) formülüyle tüm boşlukları - işaretine çevir.
4. Özel karakterleri temizle: Nokta, virgül, slash, tırnak gibi URL için geçersiz tüm sembolleri tablodan kaldır.

Detaylı sütun kurallarını incelemek için Shopify Ürün CSV Formatı: Şablon ve Sütun Rehberi yazımıza 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ç

CSV ile ürün yüklerken Handle kuralları ve varyant yönetimi

Shopify CSV dosyasında Handle sütunu ilk sütundur ve en kritik role sahiptir. Bir ürünün 5 farklı bedeni veya 4 farklı ürün görseli varsa, bu satırların tamamında Handle hücresi birebir aynı yazılmalıdır. Ancak ürün başlığı (Title), açıklama (Body (HTML)), kategori ve etiketler yalnızca ilk satırda yer almalı, varyant satırlarında bu alanlar boş bırakılmalıdır.

Farklı platformlardan gelen verileri dönüştürürken, örneğin İkas Ürünlerini Shopify’a Taşıma: Adım Adım Rehber adımlarını uygularken veya İkas → Shopify ve Trendyol → Shopify gibi dönüştürücüler kullanırken bu handle kuralı otomatik işletilir.

Aşağıdaki tabloda handle oluşturma kuralları ve örnek dönüşümler özetlenmiştir:

Ürün Başlığı / Orijinal Veri	Geçerli Shopify Handle	Hatalı Kullanım / Hata Sebebi
Erkek Deri Ceket - Siyah (2026)	erkek-deri-ceket-siyah-2026	Erkek Deri Ceket (Büyük harf ve boşluk içeremez)
%100 İpek Şal / Kırmızı	100-ipek-sal-kirmizi	%100_İpek_Şal/Kırmızı (Yüzde, alt çizgi ve slash barındıramaz)
Kadın Koşu Ayakkabısı No: 38	kadin-kosu-ayakkabisi-no-38	kadin-koşu-ayakkabisi-no:-38 (Türkçe ‘ş’ ve iki nokta üst üste içeremez)
V Yaka Basic T-Shirt	v-yaka-basic-t-shirt	v--yaka---basic-t-shirt (Art arda birden fazla tire okunurluğu bozar)

Farklı bir e-ticaret kaynağından dosya hazırlıyorsan elindeki veriyi doğrudan Excel / CSV → Shopify aracına yükleyerek sütunları ve varyant handle bağlarını sıfır hata ile standart şablona dönüştürebilirsin.

Sık yapılan hatalar

• Hata: Aynı ürünün varyant satırlarında farklı handle değerleri tanımlamak.
  Sonucu: Shopify her varyant satırını bağımsız, tekil birer ürün olarak içeri aktarır ve mağaza kataloğunda yüzlerce mükerrer ürün oluşur.
  Çözümü: Bir ana ürüne ait beden, renk veya görsel satırlarının tamamında Handle sütununa birebir aynı metni yaz.

• Hata: Handle içinde Türkçe karakter (ç, ğ, ı, ö, ş, ü) ve büyük harf bırakmak.
  Sonucu: CSV yükleme aşamasında içe aktarma aracı satır hatası verir ya da URL tarayıcılarda bozuk karakter kodlarıyla (%C3%A7 gibi) görüntülenir.
  Çözümü: İçe aktarmadan önce tablodaki tüm metinleri standart İngilizce alfabesindeki küçük harflere (c, g, i, o, s, u) dönüştür.

• Hata: Handle değerinde boşluk veya özel simgeler (&, /, %, +, ?) kullanmak.
  Sonucu: Ürün linkleri bozulur, 404 sayfa bulunamadı hataları meydana gelir ve arama motoru indekslemesi zarar görür.
  Çözümü: Kelimeleri ayırmak için yalnızca tek bir kısa çizgi (-) kullan, sembolleri metinden tamamen temizle.

• Hata: Mevcut ve indeks almış ürünlerin handle değerini yönlendirme oluşturmadan değiştirmek.
  Sonucu: Google’da sıralama alan eski ürün URL’leri 404 hatasına düşer ve organik trafik kaybı yaşanır.
  Çözümü: Panelden handle değiştirirken “Eski URL için yönlendirme oluştur” kutusunu mutlaka işaretle veya Navigasyon > URL Yönlendirmeleri altından 301 yönlendirmesi ekle.

• Hata: Farklı iki ana ürüne tesadüfen aynı handle değerini atamak.
  Sonucu: İkinci ürün ilk ürünün altına bir varyant gibi eklenir veya ilk ürünün üzerine yazılarak verilerin kaybolmasına yol açar.
  Çözümü: Her benzersiz ürün modeli için handle sonuna model kodu veya benzersiz bir stok kodu (SKU) ekleyerek tekilliği sağla.

Sık sorulan sorular

Handle değiştirildiğinde eski ürün linkleri kırılır mı?
Evet, handle alanını manuel değiştirdiğinizde ürünün URL adresi değiştiği için eski bağlantı kırılabilir. Ancak Shopify yönetim panelinden değişiklik yaparken “Eski URL için yönlendirme oluştur” kutusunu işaretlerseniz sistem otomatik 301 yönlendirmesi tanımlar.

Shopify handle alanında büyük harf veya Türkçe karakter kullanılabilir mi?
Hayır, Shopify handle alanında büyük harf, Türkçe karakter (ç, ğ, ı, ö, ş, ü) ve boşluk kullanılamaz. Sistem bu karakterleri otomatik olarak küçük harfe çevirir, geçersiz sembolleri siler veya tire işaretine dönüştürür.

Bir CSV dosyasında aynı handle birden fazla satırda kullanılabilir mi?
Evet, bir ürünün birden fazla varyantı veya görseli varsa bu satırların tamamında aynı handle kullanılmalıdır. Shopify, CSV içe aktarımında aynı handle değerini taşıyan ardışık satırları tek bir ana ürünün varyantları olarak birleştirir.

Handle alanı boş bırakılırsa ne olur?
Toplu yüklemelerde her ürün satırında geçerli bir handle bulunması zorunludur. Yönetim panelinden manuel ürün eklerken handle otomatik doldurulur; fakat CSV ile ürün yüklerken Handle sütunu boş bırakılırsa içe aktarma işlemi hata verir veya ürünler sisteme eklenemez.

Sonuç

Shopify mağazanda hatasız bir ürün kataloğu yönetmek, varyantları doğru bağlamak ve SEO uyumlu URL yapıları kurmak için handle kurallarını eksiksiz uygulamalısın. Dosyalarını Shopify formatına dönüştürmek için saatlerce formüllerle uğraşmak yerine AREM Labs tarafından sunulan Excel / CSV → Shopify dönüştürücüsünü kullanabilirsin. Dosyan sunucuya yüklenmeden doğrudan tarayıcında işlenir; varyantların, barkodların ve ürün handle değerlerin saniyeler içinde Shopify standartlarına hazır hale gelir.