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_referencetü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
customveyamy_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ür | Kullanım durumu örneği |
|---|---|
single_line_text_field | SKU eki, malzeme adı |
multi_line_text_field | Bakım talimatları, kısa açıklamalar |
rich_text_field | Biçimlendirilmiş ürün hikayesi, uyum notları |
boolean | Bu öğe tehlikeli mi? Evet/Hayır |
number_integer / number_decimal | Birim ağırlığı, iplik sayısı |
date / date_time | Son kullanma tarihi, piyasaya sürüş tarihi |
file_reference | Beden tablosu PDF'i, nasıl yapılır videosu |
product_reference | İlgili ürün |
collection_reference | Tamamlayıcı koleksiyon |
page_reference | Bağlantılı açılış sayfası |
article_reference | Bağlantılı blog yazısı (2025-10 API'de eklendi) |
list.* | Yukarıdakilerden herhangi biri, sıralı bir liste olarak |
json | Keyfi 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 Hızlı karar matrisi: 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: 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 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 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. 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. 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. Özel bölümler veya koşullu mantık için doğrudan Liquid'te yazın: 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. İçerik odaklı SEO, şu anda metafields'in en yüksek ROI kullanımlarından biridir. 2025-10 API'den beri kullanılabilir olan 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.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.Nisan 2026'da göz ardı edemeyeceğiniz 16 KB limit değişikliği
value alanı uzunluğunu sorgulayın.2026-04 API güncellemesi: sepet metafields'i artık siparişlere taşınıyor
cartToOrderCopyable yeteneği sipariş metafield tanımında etkinleştirilmelidir.Metafield tanımları nasıl oluşturulur (kod gerekli değil)
Metafields'i tema'nızda render etme
Dinamik kaynaklar (no-code yol)
Liquid (kod yolu)
{% 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)
SEO için metafields:
article_reference fırsatı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.Bir bakışta platform limitleri (2026 ortası itibariyle güncel)
Limit Değer Kaynak başına uygulama metafield tanımları 256 Kaynak başına tüccar metafield tanımları 256 Tanım başına girişler 1.000.000 Metafield başına maksimum değer boyutu 16 KB (Nisan 2026'dan beri) Kaçınılması gereken yaygın hatalar
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.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.
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.