Headless CMS Nedir? Klasik CMS'ten Farkı
İçeriği API ile sunan headless yapının hız, güvenlik ve çok kanallı yayın avantajlarını; klasik CMS ile karşılaştırarak anlatıyoruz.

Headless CMS, içeriğin yönetildiği paneli, içeriğin gösterildiği arayüzden ayıran içerik yönetim sistemidir. Headless CMS nedir sorusunun kısa yanıtı şudur: içerik bir kez girilir ve API üzerinden web sitesine, mobil uygulamaya, ekranlara ya da başka kanallara gönderilir. Arayüz ise bağımsız olarak, istenen teknolojiyle geliştirilir.
İçerik Yönetim Sistemi Nedir?
İçerik yönetim sistemi (CMS), teknik bilgisi olmayan birinin de sayfa, haber, ürün ya da blog yazısı ekleyip düzenleyebilmesini sağlayan yazılımdır. Panelde başlığı, metni ve görseli girersiniz; sistem bunları sitede yayınlar.
Klasik CMS'lerde içerik paneli, veritabanı ve sitenin görünümü tek bir paketin parçalarıdır. Panel içeriği kaydeder, aynı yazılım o içeriği şablonlarla birleştirip HTML sayfa olarak ziyaretçiye sunar. Bu yapıya monolitik ya da bütünleşik mimari denir.
Headless yaklaşım bu paketi ikiye böler. Adındaki “headless” (başsız) ifadesi, sistemin bir “kafası”, yani sabit bir görünüm katmanı olmadığını anlatır. Görünüm katmanı ayrı bir projedir ve içeriği API üzerinden ister.
Headless Mimari Nasıl Çalışır?
Bir headless mimari genellikle üç parçadan oluşur: içeriğin girildiği yönetim paneli, içeriği dışarıya veren API ve bu içeriği gösteren bir ya da daha fazla arayüz.
- Editör içeriği girer: panelde başlık, metin, görsel ve alanları doldurur.
- İçerik yapılandırılmış veri olarak saklanır: sayfa düzeni değil, alanlar kaydedilir (başlık, özet, gövde, yazar, tarih).
- Arayüz API'ye istek gönderir: web sitesi, mobil uygulama ya da başka bir kanal içeriği JSON olarak alır.
- Arayüz içeriği kendi tasarımıyla gösterir: aynı içerik her kanalda o kanala uygun biçimde sunulur.
- Değişiklik yayınlanır: sayfalar ya yeniden oluşturulur ya da bir sonraki istekte güncel veri çekilir.
const yanit = await fetch('https://cms.ornek.com/api/yazilar?limit=3');
const { veriler } = await yanit.json();
veriler.forEach(y => console.log(y.baslik, y.yayinTarihi));Headless ile Klasik CMS Farkı
Tabloda görüldüğü gibi headless, esneklik ve ölçek kazandırırken başlangıçta daha fazla geliştirme emeği ister. Bu yüzden her proje için doğru seçim değildir; ihtiyaçla birlikte değerlendirilmelidir.
| Ölçüt | Klasik CMS | Headless CMS |
|---|---|---|
| Mimari | Panel ve görünüm tek pakette | Panel ve görünüm ayrı |
| İçerik dağıtımı | Genellikle tek web sitesi | API ile çok kanal |
| Arayüz teknolojisi | Sistemin şablon diline bağlı | Serbest (React, Next.js vb.) |
| Önizleme | Hazır ve kolay | Ayrıca kurulması gerekir |
| Geliştirici ihtiyacı | Kurulumda daha az | Arayüz için gerekli |
| Saldırı yüzeyi | Panel ve site aynı yerde | Panel ayrı, site statik olabilir |
Headless CMS'in Avantajları
Hız ve performans
Headless yapıda arayüz, sayfaları önceden oluşturup bir CDN üzerinden sunabilir. Ziyaretçi her istekte veritabanı sorgusu beklemez; sayfa hazırdır. Bu, Core Web Vitals hedeflerine (LCP ≤ 2,5 sn, INP ≤ 200 ms, CLS ≤ 0,1) ulaşmayı kolaylaştırır. Hız konusunu hız ve performans yönetimi sayfamızda ayrıntılı anlattık.
Güvenlik
Yönetim paneli ziyaretçinin eriştiği siteden ayrı bir adreste durabilir. Site statik dosyalardan oluşuyorsa, saldırganın hedef alabileceği sunucu tarafı kod azalır. Bu, saldırı yüzeyini küçültür; ama panelin ve API'nin de korunması gerektiğini unutmayın.
Çok kanallı yayın
Aynı ürün açıklaması web sitesinde, mobil uygulamada, mağaza içi ekranda ve bir pazaryeri akışında kullanılabilir. İçerik bir kez güncellenir, her yerde değişir. Buna çok kanallı yayın (omnichannel) denir.
Teknoloji özgürlüğü
Arayüz ekibi, CMS'in şablon diline bağlı kalmadan istediği teknolojiyi seçebilir. Arayüzü yenilemek istediğinizde içerik yerinde kalır; yalnızca görünüm katmanı yeniden yazılır.
Dezavantajlar ve Dikkat Edilecekler
Headless yapının esnekliği bedelsiz değildir. Klasik bir sistemde hazır gelen pek çok özellik, burada ekip tarafından kurulur ve bakımı yapılır. Karar vermeden önce aşağıdaki maddeleri kendi projeniz açısından tek tek değerlendirin; çoğu zaman belirleyici olan teknoloji değil, ekibin ve bütçenin bu ek sorumluluğu taşıyıp taşıyamayacağıdır.
- Geliştirici bağımlılığı artar: yeni bir sayfa şablonu ya da bileşen eklemek kod gerektirir.
- Önizleme ayrıca kurulur: editörün yayınlamadan önce sayfayı görmesi için ek çalışma gerekir.
- Parça sayısı artar: CMS, API, arayüz ve barındırma ayrı ayrı yönetilir.
- SEO işi arayüze kalır: başlık etiketleri, yapılandırılmış veri ve site haritası arayüz projesinde doğru kurulmalıdır.
- Maliyet modeli farklıdır: bazı bulut CMS servisleri içerik, kullanıcı ya da API isteği sayısına göre ücretlendirir.
Jamstack Nedir?
Jamstack, headless CMS ile sık birlikte anılan bir web mimarisi yaklaşımıdır. Sayfalar derleme sırasında önceden oluşturulur, CDN üzerinden statik dosya olarak sunulur; dinamik işler ise API'ler ve JavaScript ile yapılır.
Bu yaklaşımda içerik headless CMS'ten gelir, sayfaları bir statik site üreteci ya da Next.js gibi bir çatı oluşturur. Next.js'in hem statik hem sunucu tarafı oluşturmayı nasıl birleştirdiğini Next.js nedir yazımızda anlattık.
Jamstack her projeye uymaz. Çok sık değişen, kullanıcıya göre kişiselleşen içerikte sunucu tarafı oluşturma ya da hibrit yöntemler daha uygun olabilir. Önemli olan, hangi sayfanın ne sıklıkla değiştiğine göre doğru oluşturma biçimini seçmektir.
Hangi Projelerde Tercih Edilmeli?
Karar verirken teknolojiden önce içeriğinize bakın: kaç kanal var, ne sıklıkla güncelleniyor, kaç kişi düzenliyor ve hız ne kadar kritik? Bu sorulardan en az ikisine güçlü bir evet diyorsanız headless yapı ciddi bir aday olur; aksi hâlde daha sade bir mimari genellikle hem daha hızlı hem daha ekonomik sonuç verir.
- Çok kanallı markalar: aynı içeriği web, mobil uygulama ve fiziksel ekranlarda kullanan işletmeler.
- Çok dilli ve çok bölgeli siteler: içeriğin yapılandırılmış olması çeviri yönetimini kolaylaştırır.
- Yüksek trafikli içerik siteleri: önceden oluşturulmuş sayfalar yük altında daha dayanıklıdır.
- Uygulama ve site birlikte: mobil uygulaması olan bir e-ticaret ya da rezervasyon platformu.
- Tasarımı sık yenilenen markalar: içeriği taşımadan arayüzü baştan yazmak isteyenler.
Geçiş Yaparken Neye Dikkat Edilmeli?
Mevcut bir siteden headless yapıya geçişte en önemli adım içerik modelini doğru kurmaktır. Sayfaları olduğu gibi taşımak yerine, içeriği anlamlı alanlara bölmek gerekir: ürün adı, kısa açıklama, uzun açıklama, görsel, kategori gibi.
İkinci adım URL yapısını korumaktır. Adresler değişecekse her eski adres için 301 yönlendirme planlanmalı; aksi hâlde arama motoru görünürlüğü zarar görebilir. Bu noktada SEO uyumlu web tasarımı ilkeleri yol göstericidir.
Arayüz tarafında içeriğin hangi teknolojiyle sunulacağı da baştan konuşulmalıdır. Arayüz ile sunucu arasındaki iş bölümünü frontend ve backend farkı yazımızda, sunucu tarafında hâlâ yaygın olan dillerden birini ise PHP nedir yazımızda ele aldık. Aurora Yazılım'da web tasarımı projelerinde içerik yapısı, hız hedefleri ve yönetim kolaylığı birlikte planlanır.
Sık Sorulan Sorular
01Headless CMS kullanmak için yazılımcı olmak gerekir mi?
İçerik girmek için gerekmez; editör paneli klasik CMS'lerdeki kadar kolay olabilir. Ancak arayüzü kurmak, yeni sayfa tipleri eklemek ve bakım için geliştirici desteği gerekir.
02Headless CMS SEO için daha mı iyi?
Kendiliğinden daha iyi değildir. Hızlı sayfalar SEO'ya katkı sağlar, ama başlık etiketleri, yapılandırılmış veri ve sunucudan gelen düzgün HTML arayüz projesinde doğru kurulmalıdır. Kötü kurulmuş bir headless site, iyi kurulmuş klasik bir siteden daha kötü sonuç verebilir.
03E-ticarette headless yaklaşım kullanılır mı?
Evet; buna headless commerce denir. Ürün, stok ve sipariş altyapısı arka planda çalışır, mağaza arayüzü ayrı geliştirilir. Çok kanallı satış yapan ve arayüzde tam özgürlük isteyen markalar için uygundur.
Headless CMS, içeriği arayüzden ayırarak hız, güvenlik ve çok kanallı yayın esnekliği kazandırır; karşılığında daha planlı bir geliştirme süreci ister. Projeniz için doğru mimariyi birlikte belirlemek üzere web tasarımı hizmetimizi, sektörel ihtiyaçlar için yazılım çözümlerimizi ve mağaza projeleri için e-ticaret altyapısı seçeneklerimizi inceleyebilirsiniz.


