Shopify Metafields: Ticcarlar ve Geliştirici Rehberi

Shopify metafields, mevcut mağaza kaynaklarına (ürünler, varyantlar, koleksiyonlar, siparişler, müşteriler) ekleyeceğiniz özel veri alanlarıdır ve Shopify'ın varsayılan şeması tarafından yakalanmayan bilgileri depolamanıza olanak tanır. Her Online Store 2.0 teması, bu alanları dinamik kaynaklar olarak sıfır kod düzenlemesi ile sunabilir. Eğer bir ürün sayfasında kumaş bileşimini, yakış süresini, garanti dönemini veya düzenleyici bir madde listesini görüntülemeniz gerekiyorsa, metafields doğru araçtır.

Temel çıkarımlar

• Metafields mevcut bir Shopify kaynağına ekstra veri iliştirirken, metaobjects birçok yerden referans edilen bağımsız, yeniden kullanılabilir kayıtlardır.
• Shopify API sürümü 2026-04, otomatik sepetten siparişe metafield yayılması ekledi ve bu da özel ödeme akışındaki en büyük boşluğu kaldırdı.
• Metafield başına değer sınırı Nisan 2026'da 2 MB'tan 16 KB'a düştü, yani daha büyük herhangi bir şey metaobjects'e veya Files API'sine geçmesi gerekiyor.
• Platform sınırları şu anda 256 uygulama tanımı, 256 ticcarı tanımı ve tanım başına 1 milyon giriş olarak duruyor.
• 2025-10 API sürümünde eklenen article_reference türü, ürünleri doğrudan blog yazılarına bağlamanızı sağlayarak içerik odaklı SEO için harika bir çözüm sunar.

Shopify metafield tam olarak nedir?

Metafield, bir Shopify kaynağı üzerinde bulunan yapılandırılmış bir anahtar-değer çiftidir. Her metafield'in dört gerekli özniteliği vardır:

• Mantıksal bir kapsayıcı olan namespace, örneğin custom veya my_app
• Bu namespace içindeki alan tanımlayıcısı olan key, örneğin fabric_type
• Veri tipi olan type (metin, sayı, boolean, dosya referansı, JSON, vb.)
• Depoladığınız gerçek veri olan value

Namespace ve key kombinasyonu her kaynak için benzersiz olmalıdır. Shopify, app'e ait alanlar ile ticcarı alanları arasındaki çarpışmaları önlemek için namespace kullanır.

Liquid'de, ürün metafield'ine şu şekilde erişirsiniz:

{{ product.metafields.custom.fabric_type.value }}

Rich-text alanlar için HTML çıktısını doğru şekilde işlemek amacıyla metafield_tag filtresini kullanın:

{{ product.metafields.custom.care_instructions | metafield_tag }}

Desteklenen metafield türleri

Shopify geniş bir içerik türü seti destekler. En yaygın olanları şunlardır:

2025-10 API güncellemesinde eklenen article_reference ve list.article_reference türleri, ürünleri editoryal içeriğe bağlamanın yerel bir yolunu sunarak içerik odaklı SEO stratejileri için harika bir kazançtır.

Metafields vs. metaobjects: doğru alması gereken karar

Bu, müşteri mağazalarında en yaygın mimari hatasıdır. Kural basittir:

Veri tek bir kaynağa özgü olduğunda ve yeniden kullanım değeri olmadığında metafield kullanın.

Aynı yapılandırılmış kayıt birçok kaynak arasında görüntülendiğinde veya tek bir yerde düzenlenmesi ve her yerde yansıtılması gerektiğinde metaobject kullanın.

Gerçek bir örnek: bir toptan tekstil satıcısı aynı 18 satırlık beden tablosunu 247 bireysel ürün metafield'ine yapıştırdı. Beden standardı değiştiğinde, 246 ürün sayfası eski kaldı ve biri güncellendi. Bu verileri tek bir metaobject'e taşımak 90 dakika sürdü. Şimdi bunu referans alan her ürün sayfası, tek bir düzenleme ile sonraki istekte güncellenir.

Metaobjects Şubat 2023'te tanıtıldı ve plan sınırlaması olmaksızın her Shopify planında mevcuttur. Metaobject tanımını bir veritabanı tablosu şeması olarak, her girişi satır olarak düşünün. Size_Guide tanımının başlık, görüntü ve ölçüm tablosu için alanları olabilir. Girişler oluştursunuz (T-Shirt Size Guide, Jeans Size Guide) ve bunları gerektiği kadar çok üründen referans edersiniz.

Hızlı karar matrisi:

• Ticcarının SKU başına düzenledikleri ürüne özgü metin mi? Metafield.
• 50+ tekstil SKU'su arasında paylaşılan beden tablosu mu? Metaobject.
• Ürün başına değişen mevsimsel gönderim tarihi mi? Metafield.
• Sitede kullanılan, yetkilendirilmiş satıcı listesi (ad, bölge, URL) mi? Metaobject.
• Hakkında, Kariyer ve blog yazılarından referans edilen takım üyesi kaydı mı? Metaobject.

16 KB sınırı değişikliği: göz ardı edemeyeceğiniz

Bu, son yılların en yapıcı metafield değişikliğidir. Shopify, metafield başına değer tavanını 2 MB'tan 16 KB'a düşürdü, yüzde 99,2 oranında bir azalma, bu da Nisan 2026'da yürürlüğe girdi. Belirtilen gerekçe veritabanı altyapı maliyeti ve performanstır.

Bunun pratik olarak anlamı:

• Mini-veritabanı olarak kullanılan JSON metafield'leri (eski uygulama entegrasyonlarında yaygın), şimdi 16 KB'ı aşarsa bozuk veya sessizce kırpılmıştır.
• Metafield'lere depolanan büyük rich-text blokları veya gömülü base64 görüntüleri Files API'sine taşınmalı veya metaobjects olarak yeniden yapılandırılmalıdır.
• Yeni uygulamalar 16 KB'ı tavanı olarak alacak şekilde tasarlanmalı ve metaobjects, referanslar ve daha ağır herhangi bir şey için Files API'sine dayanmalıdır.

Mağazanızın etkilenip etkilenmediğinden emin değilseniz, Admin GraphQL API'si aracılığıyla metafield'lerinizi denetleyin, herhangi bir geçişten önce value alanı uzunluğunu sorgulayın.

2026-04 API güncellemesi: sepet metafields şimdi siparişlere taşınıyor

Bu, 2026'nın en büyük geliştirici yönelik metafield haberidir. Shopify API sürümü 2026-04, belirli koşullar karşılanınca sepet metafields'in otomatik olarak sipariş metafields'lerine yayılmasını tanıttı.

Pratik gereklilik: namespace ve key tam olarak sepet tarafı ve sipariş tarafı metafield tanımları arasında eşleşmelidir ve sipariş metafield tanımında cartToOrderCopyable yeteneği etkinleştirilmiş olmalıdır.

Ticcarlar için bunun anlamı: ödeme sayfasında özel veri toplayan mağazalar (kişiselleştirme jetonları, hediye mesajı bayrakları, sadakat meta verileri, üçüncü taraf gönderim talimatları), önceden bu verileri sonuçta ortaya çıkan siparişte görünür tutmak için sepet öznitelikleri veya özel ödeme komut dosyaları'na güvenmek zorunda kaldılar. Bu parçalanmış yaklaşım artık açık izinler ve namespace kontrolleri ile birleşik metafield modeli ile değiştirilmiştir. Sonuç, uygulamalar için daha temiz erişim kontrolleri, ödeme sayfasında daha az kenar durumu ve karşılama ve raporlama iş akışları için daha öngörülebilir bir veri işlem hattıdır.

Siparişleri finans veya ERP mutabakatı için aktarmak amacıyla ETL işlem hatları kullanıyorsanız, alan eşlemelerinizi ilgili sipariş metafield değerlerini içerecek şekilde güncelleyin.

Metafield tanımları nasıl oluşturulur (kod gerekli değil)

1. Shopify Admin > Settings > Custom data'ya gidin.
2. Kaynak türünü seçin (Products, Variants, Collections, Customers, Orders, vb.).
3. Add definition'a tıklayın.
4. Bir ad, namespace, key girin ve içerik türünü seçin.
5. İsteğe bağlı doğrulamalar ekleyin (karakter sınırları, URL formatı, sayısal aralıklar).
6. Kaydedin.

Bir tanım mevcut olduğunda, dinamik kaynakları destekleyen herhangi bir Online Store 2.0 tema bölümü, tema editöründe seçilebilir bir alan olarak ortaya çıkacaktır, Liquid düzenlemesine gerek yoktur.

Toplu popülasyon için, Shopify'ın yerel CSV içeri aktarması sınırlı bir metafield sütunu seti işler. Tam kontrol için Matrixify, de facto araçtır: CSV sütunlarını doğrudan namespace-key çiftleriyle eşler ve içeri aktarma sırasında türleri doğrular.

Metafields'i temanızda işlemek

Dinamik kaynaklar (kodsuz yol)

Tema editöründe, bir OS 2.0 bölümündeki herhangi bir metin, görüntü veya medya bloğuna tıklayın, ardından Connect dynamic source simgesine (veritabanı simgesi) tıklayın. Tanımlanmış metafield'leriniz seçenekler olarak görünür. Bu, koda dokunmaması gereken içerik editörleri için doğru yoldur.

Liquid (kod yolu)

Özel bölümler veya koşullu mantık için Liquid'de doğrudan yazın:

{% if product.metafields.custom.is_hazardous.value %}
  <p class="hazard-notice">⚠ İhtiyatlı davranın. Güvenlik sayfasına bakın.</p>
{% endif %}

{% assign warranty = product.metafields.custom.warranty_years.value %}
{% if warranty %}
  <p>{{ warranty }}-yıl garanti dahildir.</p>
{% endif %}

Shopify Flow (otomasyon yolu)

Nisan 2024'ten beri Shopify Flow, yazılı metafield'leri doğrudan okuyabilir. Bir kaynak seçer, bilinen tanımlar listesinden bir metafield seçersiniz ve Flow ardışık adımlarda kullandığınız bir takma ad oluşturur. Bu, özel uygulamalar olmaksızın metafield değerlerine dayalı etiketleme, bildirimler veya karşılama yönlendirmesini otomatikleştirmek için yararlıdır.

SEO için Metafields: article_reference fırsatı

İçerik odaklı SEO, şu anda metafield'lerin en yüksek ROI kullanımlarından biridir. 2025-10 API'den beri article_reference türü mevcuttur ve ürünü doğrudan metafield tanımı içinden belirli bir blog yazısına bağlayabilirsiniz. Blog yazısı URL'si, hardcoded bir dize yerine yapılandırılmış bir referans haline gelir, bu da handle değişikliklerinden kurtulur ve yüzlerce ürün arasında manuel güncellemelere gerek duymaz.

Bu SEO için önemlidir çünkü tarayıcıların takip edebileceği gezinilebilir bir dahili bağlantı yapısı oluşturur ve destekleyen editoryal içeriği işlemsel sayfaya bağlamsal olarak yakın tutar. Geniş bir satın alma rehberi veya nasıl yapılır makalesi kütüphanesine sahip mağazalar için, bunu sistematik olarak katalog genelinde uygulamaya değer.

Yapılandırılmış verilerin ve içerik organizasyonunun mağazanızın arama görünürlüğünü nasıl etkilediğine daha geniş bir bakış için Shopify SEO hizmetleri ve Shopify tema geliştirme sayfalarına bakın.

Platform sınırlarına bakış (Orta 2026 itibariyle güncel)

Kaçınılması gereken yaygın hatalar

• Büyük JSON bloblarını tek bir metafield'de depolama. Nisan 2026'dan beri tavanda 16 KB var. Metaobjects kullanın veya verileri daha küçük yazılı alanlarla bölün.
• Binlerce ürün arasında paylaşılan verileri çoğaltma. Aynı değer bir avuç ürünün çoğundan fazlada görünüyorsa, metaobject'e ait.
• Tema bunları referans verirken üretimde metafield'leri yeniden adlandırma. Önce tema referanslarını güncelleyin, ardından tanımı yeniden adlandırın. Bunu tersine çevirmek live vitrin çıktısını bozar.
• Tanımları atlayıp raw namespace-key çiftleri kullanma. Bir tanım olmadan, tür doğrulamayı, tema editöründe dinamik kaynak desteğini ve temiz admin kullanıcı arayüzü görüntüsünü kaybedersiniz.
• Global namespace kullanma. Uygulamalar daha önce global.title ve benzeri desenleri kullanırdı. Bu namespace ayrılmıştır ve davranışı API sürümleri arasında tutarsızdır. Özel bir namespace kullanın.
• Eski uygulama metafield'lerini denetlememe. Eski uygulamalar namespace_1 veya apps.my_old_app gibi namespace'ler altında yetim metafield'ler bırakır. Bunlar tanım sınırınızın hesabına girer ve admin kullanıcı arayüzünü kirletir.