28 Ekim 2026'de piyasaya sürülen Shopify'ın tema uygulaması eklentileri özelliği, tema geliştiricilerin bir vitrin uygulamasını Tema Mağazası listesine paketlemesine olanak tanır; böylece satıcılar temayı ve uygulamayı tek bir akışta yükleyebilir. Uygulama kendisi standart bir tema uygulaması uzantısı (TAE) olarak oluşturulur, Uygulama Mağazası'na bağımsız olarak yayımlanır, ardından İş Ortağı Kontrol Paneli içinde temaya bağlanır. Bu bağlantı "eklenti" katmanıdır: altında yatan her şey, zaten bilmeniz gereken sıradan TAE mekanikleridir.
Önemli Noktalar
- Tema uygulaması eklentileri, yeni bir uzantı türü değil, 28 Ekim 2026'de açıklanan bir Shopify Tema Mağazası özelliğidir.
- Temel kod standart bir tema uygulaması uzantısıdır: uygulama blokları (
sectionhedefi) ve uygulama gömme blokları (headveyabodyhedefi). - Tema listesi başına bir eklenti; aynı uygulama sahip olduğunuz birden çok tema listesinde yeniden kullanılabilir.
- Temaya sahip iş ortağı kuruluşu uygulamaya da sahip olmalıdır.
- Eklenti oluşturan tema geliştiriciler uygulama incelemesi kuyruğunda öncelikli yerleştirme alır.
"Paketleme" Gerçekten Ne Anlama Geliyor?
Ekim 2026 öncesinde, tema uygulaması uzantıları vardı ve iyi çalışıyordu, ancak bir tema listesi ile uygulama arasındaki bağlantı tamamen gayriresmi idi. Bir tema BENIOKU dosyası "en iyi sonuçlar için X Uygulamasını yükleyin" diye söyleyebilir. Satıcılar uygulamayı ayrı olarak bulmalı, yüklemeli, ardından tema editöründe etkinleştirmeliydi. Kayıp gerçek idi.
Tema geliştiriciler artık tema uygulaması uzantılarını kullanarak vitrin uygulamaları oluşturabilir ve bunları Tema Mağazası'ndaki tema listelerine paketleyebilir. Sonuç olarak, bir uygulama eklentisi, tema uygulaması uzantılarıyla oluşturulmuş ve bir temayı ek özelliklerle genişleten bir vitrin uygulamasıdır; satıcılar bunu tema listesinden keşfedebilir ve temayı ile uygulamayı aynı anda yükleyebilir.
Bu tek yükleme akışı anlamlı değişikliktir. Uzantı kodu kendisi her zaman aynı kuralları izler.
Yapı Taşları: TAE Yapısı
Tema uygulaması uzantı dosya yapısının uygulama blok dosyaları ve uygulama gömme blok Liquid dosyalarını içeren bir blocks alt dizini ve diğer uygulama blokları ve uygulama gömme bloklarında başvurabileceğiniz Liquid parçacık dosyaları için bir snippets alt dizini vardır.
Shopify CLI ile yeni uzantı öğrenme:
shopify app generate extension --type theme_app_extension --name my-addon
Bu oluşturur:
extensions/
my-addon/
blocks/
my_block.liquid
snippets/
assets/
locales/
shopify.extension.toml
shopify.extension.toml dosyası uzantının adını ve türünü tanımlar ve isteğe bağlı olarak tanıtıcısını tanımlar.
Minimal shopify.extension.toml:
name = "my-addon"
type = "theme"
Uygulama Blokları vs. Uygulama Gömme Blokları
Tema uygulaması uzantıları, uygulamanıza çevrimiçi mağazadaki temalar genişleten iki tümleştirme türü sağlar: uygulama blokları ve uygulama gömme blokları.
Her iş için doğru olanı kullanın:
| Tümleştirme Türü | target Değeri | Nerede Görünür | Satıcı Denetimi |
|---|---|---|---|
| Uygulama Bloku | section | Bir bölüm içinde, satıcı tarafından yerleştirildi | Tema editöründe ekle, taşı, kaldır |
| Uygulama Gömmesi (head) | head | Kapanış </head> öncesinde | Tema Ayarları > Uygulama Gömmelerinde aç/kapat |
| Uygulama Gömmesi (body) | body | Kapanış </body> öncesinde | Tema Ayarları > Uygulama Gömmelerinde aç/kapat |
Tipik bir uygulama bloku Liquid dosyası:
<div class="my-addon" style="background: {{ block.settings.bg_color }}">
{{ block.settings.heading }}
</div>
{% schema %}
{
"name": "My Add-on Block",
"target": "section",
"stylesheet": "my-addon.css",
"settings": [
{
"type": "color",
"id": "bg_color",
"label": "Background colour",
"default": "#ffffff"
},
{
"type": "text",
"id": "heading",
"label": "Heading",
"default": "Hello from the add-on"
}
]
}
{% endschema %}
Varsayılan olarak, bir uygulama yüklendikten sonra uygulama gömme blokları devre dışı bırakılır. Satıcılar tema editöründen Tema Ayarları > Uygulama Gömmelerinden uygulama gömme bloklarını etkinleştirmesi gerekir. Bu, yeni tek yükleme akışının kısmen çözdüğü bir uyuşmazlık noktasıdır: satıcı yine de gömmeleeri değiştirmesi gerekir, ancak en azından editörü açmadan önce uygulamayı yüklediğine sahiptir.
Tema Bölümlerinizi Uygulama Bloklarını Kabul Etmek İçin Hazırlama
Satıcıların bir bölüme veya tema bloğuna uygulama blokları eklemesine izin vermek için, bölüm veya blok şemasında @app türündeki genel bir blok eklemeniz gerekir.
// Bir bölümün şeması içinde
{
"name": "Product info",
"blocks": [
{ "type": "@app" }
]
}
@app türü, Shopify'ın tema editörüne yüklü uygulama bloklarını o bölüm içinde kullanılabilir seçenekler olarak göstermesini söyler. Olmadan, uygulama blokları yalnızca bağımsız bölümler olarak eklenebilir, tema içeriğinin yanında konumlandırılamaz.
Eklenti ile gönderilecek temayı oluşturuyorsanız, her iki tarafı da kontrol edersiniz. Eklenti blokunun mantıklı olduğu her bölüme "type": "@app" ekleyin. Blok yalnızca belirli şablonlarda görünmelidir, enabled_on kullanın:
{% schema %}
{
"name": "Subscription Widget",
"target": "section",
"enabled_on": { "templates": ["product"] }
}
{% endschema %}
Bir şemada enabled_on veya disabled_on birini kullanabilirsiniz, ikisini birden değil.
Blok Sınırı: Bir TAE Kaç Blok Tutabilir?
3 Şubat 2026 itibariyle, tek bir tema uygulaması uzantısına en fazla 30 uygulama bloku dahil edebilirsiniz; bu önceki 25 sınırından artışlıdır. Çoğu eklenti için 2 ila 5 blok göndereceksiniz; bu sınır gerçek bir kısıtlama değildir. Ancak ürün sayfaları, koleksiyon sayfaları, alışveriş sepeti çekmeceler ve altbilgiler için bloklara sahip kapsamlı bir eklenti oluşturuyorsanız, tavanı bilmek faydalıdır.
Uygulamayı Tema Listesine Bağlama (Gerçek "Eklenti" Adımı)
Burası Ekim 2026 özelliğinin yaşadığı yerdir. Kurallar, resmi değişiklik günlüğünden direkt olarak:
Uygulama, tema listesine eklenebilmek için tüm Uygulama Mağazası gereksinimlerini karşılaması ve yayımlanması gerekir. Uygulamayı tema listesine eklemek için iş ortağı kuruluşunun uygulamaya sahip olması gerekir. Tema başına yalnızca bir uygulama eklentisiyle ilişkilendirebilirsiniz, ancak aynı uygulamayı birden çok temada kullanabilirsiniz. Uygulama eklentileri listelenebilir veya listelenebilir. Uygulama adı, uygulama kartı alt başlığı, fiyatlandırma bilgisi ve öne çıkan medya satıcılara tema listesinde gösterilir.
İş Ortağı Kontrol Paneli'ndeki iş akışı:
- TAE'yi
shopify app deployile oluşturun ve dağıtın. - Uygulamayı Uygulama Mağazası'na gönderin ve yayımlanmasını sağlayın (veya sadece temaya özel dağıtım kanalı istiyorsanız listelenmeyen olarak ayarlayın).
- İş Ortağı Kontrol Paneli'ni açın, tema listesine gidin ve eklenti bölümünü bulun.
- Uygulamayı ekleyin. Tema listesi sayfası artık temayı yanında uygulamanın fiyatlandırma kartını gösterecek.
Eklenti oluşturan tema geliştiriciler ayrıca uygulama incelemesi kuyruğunda öncelik alır. Tipik inceleme zaman dilimlerine göre bu anlamlı pratik bir avantajdır.
Uygulama Mağazası Gönderimi: TAE Kontrolü
Uygulamanız Shopify teması ile tümleşirse ve Shopify Uygulama Mağazası'na göndermeyi planlıyorsanız, tema uygulaması uzantıları kullanmalısınız. Bu gereksinim gönderim sırasında uygulanır. Otomatik ön gönderim kontrolleri artık tema uygulaması uzantıları gereksinim kontrolü içerir; bu nedenle değerlendirici uygulamanızı alıp işlemden önce düzeltilmesi gereken bir şey varsa anında bileceksiniz.
Otomatik kontrolün başarısız olmasının en yaygın nedeni, yerel olarak uzantı oluşturdığınız halde asla shopify app deploy çalıştırıp yayımlanmış bir sürüm göndermediğiniz durumdur. Kontrol, yerel yapı iskelesi değil, yayımlanmış durumu okur. Önce dağıtın, ardından yeniden gönderin.
Göndermeden önce doğrulamak için kara liste öğeleri yaygındır:
shopify.extension.tomldoğrutype = "theme"değerine sahip.blocks/altında en az bir blok Liquid dosyası vardır.- Uzantı dağıtılmış ve yayımlanmış bir uygulama sürümüne dahildir.
- Uygulama kendisi tüm standart Uygulama Mağazası listesi gereksinimlerini karşılar (1200x1200px ikon, anahtar kelime yüklenmesiz alt başlık, demo mağaza URL'si).
Performans Konuları
Bir uygulamayı temaya paketlemek, onu vitrin performans kurallarından muaf etmez. İnceleme kontrol listesine satırlarla değecek birkaç şey:
- CSS: blok şemasında bir stil sayfasına başvurun (
"stylesheet": "my-addon.css"). Shopify, bunu genel olarak değil blok ile kapsamını ve yükler. Tüm CSS'nizi global bir uygulama gömmesine yapmayın; gerçekten site genelinde olmadıkça. - JavaScript: aynı prensip. Shopify'ın tema uygulaması bloklarını kullanan uygulamalar eşzamansız olarak yüklenir ve minimum performans etkisine sahip, tema kodunu doğrudan düzenleyen eski uygulamalar LCP etkileyebilirken. TAE modeli size bu eşzamansız yüklemeyi ücretsiz verir, ancak yalnızca blok kendi Liquid içinde işlememeyi engellememişse.
- Uygulama gömme konumu: analitik veya yardımcı programlar için, gerçek bir nedeniniz olmadıkça
"target": "body"tercih edin"target": "head"yerine ilk boyama öncesinde çalışmak için. - Kayan bileşenler için uygulama gömme bloklarının sayfa içeriğini gizlemeden düzgün konumlandırıldığını doğrulayın; tema editöründen uygulama gömme bloklarını etkinleştirebileceğinizi ve devre dışı bırakabileceğinizi ve ayarlarını yapılandırabileceğinizi doğrulayın.
Karşılaştırma: Temaya Paketlenen İşlevsellik İçin Dağıtım Modelleri
| Yaklaşım | Güncelleştirmeleri Kim Kontrol Eder | Satıcı Yükleme Adımları | Uygulama Mağazası Gerekli | Tema Sayfasında Eklenti Listesi |
|---|---|---|---|---|
| Tema Uygulaması Eklentisi (Ekim 2026) | Uygulama Geliştiricisi (TAE Sürümleme) | Tema Listesinden Tek Akış | Evet (Yayımlanmış veya Listelenmeyen) | Evet, Fiyatlandırma Kartıyla |
| Eklenti Bağlantısı Olmadan TAE | Uygulama Geliştiricisi | Uygulamayı Ayrı Bul, Yükle, Editörde Etkinleştir | Evet | Hayır |
| Sabit Kodlanmış Tema Özelliği | Tema Geliştiricisi | Hiçbiri (Tema ile Gönderilir) | Hayır | Hayır |
| Eski Komut Dosyası Enjeksiyonu (Kullanımdan Kaldırıldı) | Uygulama Geliştiricisi (Riskli) | Uygulama Yüklemesi + El Kodları Yapıştırma | Hayır (Ancak Uygulama Mağazası için Gerekli) | Hayır |
Eklenti modeli ortaya net oturuyor: uygulamanın bağımsız sürümlenmesini, Shopify tarafından yönetilen dağıtım ve faturalandırmayı ve satıcı rahatlığı için tek bir yüklemeyi alırsınız.
Listelenmeyen Uygulamalar Hakkında Bir Not Temaya Özel Eklenti Olarak
Tek kullanılan desen: uygulamayı listelenmeyen olarak yayımlayın. Asla Uygulama Mağazası arama sonuçlarında görünmez. Satıcı bunu bulmanın tek yolu tema listesininizdir. Bu, uygulamanın spesifik teziniz tasarım sisteminizin dışında hiç değer yoksa veya özellikleri temaya özel tutmak istiyorsanız faydalıdır. Uygulama yine de incelemeden geçer, yine de Shopify Uygulama Fiyatlandırması kullanır ve yine de satıcının yüklü uygulamalar listesinde görünür. Yalnızca genel bir arama listesi almaz.
Uzantı sürümlemeişinin mağaza düzeyinde dağıtımlarla nasıl etkileşim kurduğuna ilişkin işlenmiş bir örnek için bu sitenin vaka çalışmaları bölümüne bakın. "Uygulama gömme bloku" vs "Uygulama bloku" gibi terimler için bir terim defteri tanımı için, terim defteri özlü girdiler içerir.
Başlatmadan Önce Doğrulanacaklar
- TAE'yi dağıtın (
shopify app deploy) ve yayımlanmış sürümün uzantı içerdiğini doğrulayın. - Bir geliştirme mağazası açın, uygulamayı yükleyin, tema editörünü açın ve bloklar Uygulamalar paneli altında görünür doğrulayın.
- Tema Ayarları > Uygulama Gömmelerinde uygulama gömmesini kapalı ve açık olarak değiştirin; her durumda konsol hatası yok doğrulayın.
- Tema Inspector'u blok aktif durumdayken ürün sayfasında çalıştırın. Blok varlıklarınızın LCP kritik yolunda görünmeyip görünmediğini kontrol edin.
- Uygulamayı gözden geçirmeye gönderin. Otomatik ön gönderim kontrollerini izleyin. TAE kontrolü başarısız olursa, dağıtım durumunu doğrulayın.
- Uygulama yayımlandıktan sonra, İş Ortağı Kontrol Paneli'ni açın, tema listesine gidin ve uygulamayı eklenti olarak bağlayın.
- Tema Mağazası listesini satıcı istediği gibi yükleyin ve uygulama fiyatlandırma kartının görünür olduğunu doğrulayın.
İskelet den canlı eklentiye kadar olan tüm akış basit; "paketlemeişinin" standart TAE'nin üzerine katmanlanmış İş Ortağı Kontrol Paneli yapılandırması adımı olduğunu anladığınızda. Uzantıyı doğru oluşturun; eklenti bağlantısı beş dakikalık kontrol paneli işidir.
Sıkça sorulan sorular
Shopify tema uygulaması eklentisi nedir?
Tema uygulaması eklentisi, bir tema uygulaması uzantısı ile oluşturulmuş ve Shopify Tema Mağazası listesine bağlanan bir vitrin uygulamasıdır; böylece satıcılar temayı ve uygulamayı tek akışta yükleyebilir. Özellik 28 Ekim 2026'de tanıtılmıştır. Uygulama kendisi standart bir Uygulama Mağazası uygulamasıdır ve bağlanabilmek için önce yayımlanması gerekir.
Tek bir tema listesine birden fazla uygulama ilişkilendirebilir miyim?
Hayır. Shopify, tema listesi başına yalnızca bir uygulama eklentisine izin verir. Ancak, temaya sahip iş ortağı kuruluşu uygulamaya da sahip olması koşuluyla, aynı uygulama birden çok tema listesinde yeniden kullanılabilir.
Tema uygulaması uzantıları tüm Shopify temalarında çalışır mı?
Uygulama blokları, Dawn veya Horizon gibi JSON şablonlarını kullanan ve her yerde bölümleri destekleyen Online Store 2.0 teması gerektirir. Uygulama gömme blokları daha geniş uyumludur, ancak Shopify tam editör tümleştirmesi için yine de Online Store 2.0 temalarını önerir. Eski temalar Asset REST API gerektirir; bu, yeni geliştirme için önerilmez.