← Tüm yazılar Shopify Metafields: Kurulum, Metaobjects ve Değişiklikler Açıklandı

Shopify Metafields: Kurulum, Metaobjects ve Değişiklikler Açıklandı

Shopify metafields'in nasıl çalıştığını, metaobjects'i ne zaman kullanacağınızı ve 2026 platform değişikliklerini öğrenin.

Shopify metafields, mevcut mağaza kaynaklarına (ürünler, varyantlar, koleksiyonlar, siparişler, müşteriler) ekleyeceğiniz ve Shopify'nin varsayılan şeması tarafından yakalanmayan bilgileri depolamak için kullandığınız özel veri alanlarıdır. Her Online Store 2.0 teması, bu alanları dinamik kaynaklar olarak sıfır kod değişikliği ile yüzeyselleştirebilir. Bir ürün sayfasında kumaş bileşimini, yanma süresini, garanti süresini veya yasal bileşen listesini göstermeniz gerekiyorsa, metafields doğru araçtır.

Temel Çıkarımlar

  • Metafields mevcut bir Shopify kaynağına ekstra veri ekler; metaobjects ise birçok yerden referans alınan bağımsız, yeniden kullanılabilir kayıtlardır.
  • Shopify API sürümü 2026-04, otomatik sepet-sipariş metafield yayılımı ekledi ve özel kasa veri akışlarında en büyük boşluğu ortadan kaldırdı.
  • Metafield başına değer limiti Nisan 2026'da 2 MB'den 16 KB'ye düştü, bu da daha büyük her şeyin metaobjects veya Files API'ye taşınması gerektiği anlamına gelir.
  • Platform limitleri şu anda 256 uygulama tanımı, 256 tüccar tanımı ve tanım başına 1 milyon giriş olarak belirlenmiştir.
  • 2025-10 API yayınında eklenen article_reference türü, ürünleri doğrudan blog yazılarına bağlamanıza ve içerik odaklı SEO için yardımcı olur.

Shopify metafield tam olarak nedir?

Metafield, Shopify kaynağı üzerinde bulunan yapılandırılmış bir anahtar-değer çiftidir. Her metafield dört gerekli özelliğe sahiptir:

  • Namespace, mantıksal bir konteyner, örneğin custom veya my_app
  • Key, bu namespace içindeki alan tanımlayıcısı, örneğin fabric_type
  • Type, veri türü (metin, sayı, boole, dosya referansı, JSON, vb.)
  • Value, depoladığınız gerçek veriler

Namespace ve key kombinasyonu kaynak başına benzersiz olmalıdır. Shopify, uygulama tarafından sahip olunan alanlar ile tüccar tarafından sahip olunan alanlar arasındaki çarpışmaları önlemek için namespace'leri kullanır.

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

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

Zengin metin alanları için, HTML çıktısını doğru şekilde render etmek üzere metafield_tag filtresini kullanın:

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

Desteklenen metafield türleri

Shopify geniş bir içerik türü setini destekler. En sık kullanılanlar:

TürKullanım durumu örneği
single_line_text_fieldSKU eki, malzeme adı
multi_line_text_fieldBakım talimatları, kısa açıklamalar
rich_text_fieldBiçimlendirilmiş ürün hikayesi, uyum notları
booleanBu öğe tehlikeli mi? Evet/Hayır
number_integer / number_decimalBirim ağırlığı, iplik sayısı
date / date_timeSon kullanma tarihi, piyasaya sürüş tarihi
file_referenceBeden tablosu PDF'i, nasıl yapılır videosu
product_referenceİlgili ürün
collection_referenceTamamlayıcı koleksiyon
page_referenceBağlantılı açılış sayfası
article_referenceBağlantılı blog yazısı (2025-10 API'de eklendi)
list.*Yukarıdakilerden herhangi biri, sıralı bir liste olarak
jsonKeyfi yapılandırılmış veriler (Nisan 2026'dan beri 16 KB ile sınırlı)

2025-10 API güncellemesinde eklenen article_reference ve list.article_reference türleri, ürünleri editoryal içeriğe bağlamak için yerel bir yol sağlar; bu, içerik odaklı SEO stratejileri için net bir kazançtır.

Metafields vs. metaobjects: doğru almanız gereken karar

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

Metafield kullanın

Metaobject kullanın

Gerçek bir örnek: bir toptan tekstil tüccarı aynı 18 satırlık beden tablosunu 247 ayrı ürün metafield'ine yapıştırdı. Beden standardı değiştiğinde, 246 ürün sayfası eski kalırken bir tane güncellendi. Bu verileri tek bir metaobject'e taşımak 90 dakika sürdü. Şimdi onu referans alan her ürün sayfası, tek bir düzenlemeden sonraki isteğe göre güncellenir.

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

Hızlı karar matrisi:

  • Bir tüccarın SKU başına düzenlemediği ürüne özgü kopyalama? Metafield.
  • 50+ apparel SKU'su arasında paylaşılan beden tablosu? Metaobject.
  • Ürün başına değişen mevsimsel kargo son tarihi? Metafield.
  • Site genelinde kullanılan yetkili satıcı listesi (ad, bölge, URL)? Metaobject.
  • Hakkında, Kariyer ve blog yazılarından referans alınan takım üyesi kaydı? Metaobject.

Nisan 2026'da göz ardı edemeyeceğiniz 16 KB limit değişikliği

Bu, son yılların en yıkıcı metafield değişikliğidir. Shopify, metafield başına değer tavanını 2 MB'den 16 KB'ye indirdi, bu da yüzde 99,2 oranında bir azalmadır ve Nisan 2026'da yürürlüğe girdi. Belirtilen neden, veritabanı altyapısı maliyeti ve performanstır.

Bu pratik olarak şu anlama gelir:

  • Mini veritabanı olarak kullanılan JSON metafields (eski uygulama entegrasyonlarında yaygın), 16 KB'yi aşarsa artık bozuk veya sessizce kesilir.
  • Metafield'lerde depolanan büyük zengin metin blokları veya gömülü base64 resimler, Files API'ye taşınmalı veya metaobjects olarak yeniden yapılandırılmalıdır.
  • Yeni uygulamalar, ilk günden itibaren 16 KB'yi tavan olarak tasarlanmalı, daha ağır şeyler için metaobjects, referanslar ve Files API'ye güvenmelidir.

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

2026-04 API güncellemesi: sepet metafields'i artık siparişlere taşınıyor

Bu, 2026'nın en büyük geliştirici yönelimli metafield haberidir. Shopify API sürümü 2026-04, belirli koşullar karşılandığında sepet metafield'lerinin sipariş metafield'lerine otomatik yayılımını tanıttı.

Pratik gereklilik: namespace ve key, sepet tarafı ve sipariş tarafı metafield tanımları arasında tamamen eşleşmeli ve cartToOrderCopyable yeteneği sipariş metafield tanımında etkinleştirilmelidir.

Bu tüccarlar için neden önemlidir: kasa sırasında özel veriler toplayan mağazalar (kişiselleştirme belirteçleri, hediye mesaj bayrakları, sadakat metaveri, üçüncü taraf kargo talimatları) önceden bu verilerin ortaya çıkan sipariş üzerinde görünür kalmasını sağlamak için sepet özniteliklerine veya özel kasa komut dosyalarına güvenmek zorundaydı. Bu parçalanmış yaklaşım artık açık izinler ve namespace kontrolleri ile birleştirilmiş bir metafield modeliyle değiştirilmiştir. Sonuç, uygulamalar için temiz erişim kontrolleri, kasa sırasında daha az kenar durumu ve fulfillment ve raporlama iş akışları için daha tahmin edilebilir veri boru hattıdır.

Siparişleri finansman veya ERP uzlaştırması için dışa aktarmak üzere ETL boru hatlarını kullanıyorsanız, ilgili sipariş metafield değerlerini içerecek şekilde alan eşlemelerinizi güncelleyin.

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

  1. Shopify Admin'e gidin > Ayarlar > Özel veriler.
  2. Kaynak türünü seçin (Ürünler, Varyantlar, Koleksiyonlar, Müşteriler, Siparişler, vb.).
  3. Tanım ekle'ye 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 limitleri, URL formatı, sayısal aralıklar).
  6. Kaydedin.

Bir tanım varsa, dinamik kaynakları destekleyen herhangi bir Online Store 2.0 tema bölümü, tema editöründe seçilebilir bir alan olarak ortaya çıkarır; Liquid düzenleme gerekmez.

Toplu popülasyon için, Shopify'nin yerel CSV ithalatı sınırlı bir metafield sütun setini yönetir. Tam kontrol için Matrixify fiili standarttır: CSV sütunlarını doğrudan namespace-key çiftlerine eşler ve ithalat sırasında türleri doğrular.

Metafields'i tema'nızda render etme

Dinamik kaynaklar (no-code yol)

Tema editöründe, OS 2.0 bölümündeki herhangi bir metin, resim veya medya bloğuna tıklayın, ardından Dinamik kaynağı bağla simgesine (veritabanı simgesi) tıklayın. Tanımlanmış metafield'leriniz seçenek 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 doğrudan Liquid'te yazın:

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

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

Shopify Flow (otomasyon yolu)

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

SEO için metafields: article_reference fırsatı

İçerik odaklı SEO, şu anda metafields'in en yüksek ROI kullanımlarından biridir. 2025-10 API'den beri kullanılabilir olan article_reference türü ile, bir ürünü ürün metafield tanımı içinden belirli bir blog yazısına doğrudan bağlayabilirsiniz. Blog yazısı URL'si, sabit kodlanmış bir dize yerine yapılandırılmış bir referans haline gelir; bu, kolu değişikliklerinden sağ kalır ve yüzlerce ürün genelinde manuel güncelleştirmeler gerektirmez.

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

Mağazanızın arama görünürlüğünü nasıl yapılandırılmış veri ve içerik organizasyonunun etkilediği hakkında daha geniş bir bakış için, Shopify SEO hizmetleri ve Shopify tema geliştirme sayfalarımıza bakın.

Bir bakışta platform limitleri (2026 ortası itibariyle güncel)

LimitDeğer
Kaynak başına uygulama metafield tanımları256
Kaynak başına tüccar metafield tanımları256
Tanım başına girişler1.000.000
Metafield başına maksimum değer boyutu16 KB (Nisan 2026'dan beri)

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

  • Büyük JSON bloblarını tek bir metafield'de depolama. Nisan 2026'dan beri tavan 16 KB'dir. Verileri metaobjects'e ayırın veya daha küçük yazılan alanlara bölün.
  • Paylaşılan verileri binlerce ürün genelinde çoğaltma. Aynı değer bir avuç ürünün fazlasında görünüyorsa, metaobject'te bulunmalıdır.
  • Tema onları referans alırken üretimde metafield'leri yeniden adlandırma. Tema referanslarını önce güncelleyin, ardından tanımı yeniden adlandırın. Bu sırayı tersine çevirmek canlı depo çıktısını bozar.
  • Tanımları atlama ve ham namespace-key çiftlerini kullanma. Bir tanım olmaksızın, tür doğrulamayı, tema editöründe dinamik kaynak desteğini ve temiz yönetim kullanıcı arayüzü görüntüsünü kaybedersiniz.
  • global namespace'i kullanma. Uygulamalar önceden global.title ve benzeri desenler kullandı. Bu namespace ayrılmıştır ve davranışı API sürümleri genelinde tutarsızdır. Özel namespace kullanın.
  • Eski uygulama metafield'lerini denetleme. Eski uygulamalar namespace_1 veya apps.my_old_app gibi namespace'ler altında yetim metafield'ler bırakırlar. Bunlar tanım limitinize karşı sayılır ve yönetim kullanıcı arayüzünü kirletir.
shopifymetafieldsmetaobjectscustom dataliquid

Sıkça sorulan sorular

Shopify metafield ile metaobject arasındaki fark nedir?

Metafield, ürün veya sipariş gibi mevcut bir Shopify kaynağına tek bir özel veri özniteliği ekler. Metaobject, ürünler, sayfalar veya koleksiyonlar arasında birçok yerden referans alınabilecek, birden fazla alana sahip bağımsız, yeniden kullanılabilir yapılandırılmış bir kayıttır.

Shopify metafields'i kullanmak için kodlama becerilerine ihtiyacım var mı?

Hayır. Metafield tanımları oluşturabilir ve değerleri tamamen Shopify Admin'den Ayarlar > Özel veriler altında doldurabilirsiniz. Online Store 2.0 temaları, görsel editör kullanarak metafields'i tema bölümlerine bağlamanıza izin verir; Liquid gerekli değildir. Kodlama, yalnızca gelişmiş koşullu render etme veya özel bölüm düzenleri için gereklidir.

2026'da Shopify metafield boyut limitine ne oldu?

Nisan 2026'da Shopify, tek bir metafield için maksimum değer boyutunu 2 MB'den 16 KB'ye indirdi. 16 KB'den büyük herhangi bir metafield değeri, metaobject olarak yeniden yapılandırılmalı, daha küçük yazılan alanlara bölünmeli veya Shopify Files API'ye taşınmalıdır.