Schema Markup (Yapısal Veri) Nedir, Nasıl Eklenir? JSON-LD, Test Araçları ve WordPress

Yapısal veri, bir sayfadaki bilginin ne olduğunu (bir işletme mi, bir ürün mü, bir makale mi, bir etkinlik mi) arama motorlarına ortak bir sözlükle ve makinenin okuyabileceği bir biçimde anlatan koddur; schema markup da bu kodun schema.org sözlüğüyle yazılmış hâlidir. Pratikte Google bu işaretlemeyi sayfanın içeriğini anlamak için kullanır ve desteklediği türlerde sayfayı yıldız puanı, fiyat ya da içerik haritası gibi ek bilgiler gösteren zengin sonuçlara uygun hâle getirebilir. Uygunluk, zengin sonucun mutlaka gösterileceği ya da sıralamanın yükseleceği anlamına gelmez.

Bu rehberde işaretlemenin nasıl çalıştığı, hangi biçimin seçileceği, Google’ın hangi türleri desteklediği ve son yıllarda sık sorulan sorular sonucunda yaşanan değişiklikler Google Arama Merkezi belgelerine dayanılarak anlatılıyor. Ardından schema markup’ın adım adım nasıl ekleneceği, WordPress sitelerde nelere dikkat edileceği, doğrulama araçları ve en sık yapılan hatalar ele alınıyor. Google’ın Türkçe belgelerinde bu kavram “yapılandırılmış veri” olarak geçer; yazıda iki ifade aynı anlamda kullanılıyor.

Yapısal Veri Nedir ve Nasıl Çalışır?

Yapısal veri nedir sorusunun en sade cevabı şudur: sayfanın görünen içeriğini değiştirmeden o içeriğin anlamını etiketleyen ek bir katman. Bu katman, “bu metin bir işletme adıdır, bu rakam fiyattır, bu tarih yayın tarihidir” bilgisini standart alan adlarıyla verir. Google’ın yapılandırılmış verinin işleyişini anlatan belgesi, bu işaretlemeyi hem sayfanın içeriğini anlamak hem de işaretlemede geçen kişi, şirket veya kitap gibi varlıklar hakkında bilgi toplamak için kullandığını belirtir.

Sözlüğün büyük kısmı schema.org’dan gelir; bu, arama motorlarının birlikte geliştirdiği açık bir tür ve özellik listesidir. Ancak Google, kendi Arama davranışını anlamak için schema.org belgeleri yerine Arama Merkezi belgelerine bakılmasını önerir. Schema.org’da binlerce tür ve özellik bulunur, Google ise bunların yalnızca bir kısmını zengin sonuç için kullanır ve her tür için hangi özelliklerin zorunlu, hangilerinin önerilen olduğunu ayrıca tanımlar.

Temel kural, işaretlemenin sayfada gerçekten görünen içeriği anlatmasıdır. Aynı belge, yalnızca işaretleme koymak için boş sayfalar oluşturulmamasını ve bilgi doğru olsa bile kullanıcının göremediği içerik için işaretleme eklenmemesini açıkça ister.

Schema Markup Sıralamayı Yükseltir mi?

Google’ın belgeleri schema markup’ı bir sıralama avantajı olarak değil, içeriği anlamaya ve zengin sonuçlara uygunluğa yardımcı olan bir araç olarak tanımlar; hiçbir resmi belge işaretleme eklemenin sıralamayı yükselteceğini söylemez. Beklenti bu çerçevede kurulduğunda hayal kırıklığı yaşanmaz.

Google’ın genel yapılandırılmış veri yönergeleri bu konuda iki önemli not düşer. Birincisi, sayfa Zengin Sonuçlar Testi’nde doğru işaretlenmiş görünse bile Google işaretlenen bilgilerin arama sonuçlarında gösterileceğini garanti etmez; algoritma arama geçmişi, konum ve cihaz gibi değişkenlere göre bazen düz metin sonucunu daha uygun bulabilir. İkincisi, yapısal veriyle ilgili bir manuel işlem uygulandığında sayfa zengin sonuç görünümüne uygunluğunu kaybeder ama web aramasındaki sıralaması bu işlemden etkilenmez.

Bu iki not, schema işaretlemesinin sıralama sisteminden ayrı bir görünüm katmanı gibi ele alındığını gösterir. Değeri, uygun türlerde sonucun daha bilgilendirici görünmesi ve içeriğin makineler tarafından daha net anlaşılmasıdır; sıralama ise içeriğin kalitesi, niyete uygunluğu ve sitenin genel durumuyla belirlenir.

JSON-LD, Mikro Veri ve RDFa: Hangi Biçim Seçilmeli?

Google üç biçimi de destekler, ancak uygulaması ve sürdürmesi en kolay olduğu için çoğu durumda JSON-LD kullanılmasını önerir. Üç biçim, doğru uygulandıkları sürece Google için aynı değeri taşır; fark, kodun sayfaya nasıl yerleştirildiği ve bakımının ne kadar kolay olduğudur.

BiçimSayfaya nasıl eklenir?Güçlü yanıDikkat edilecek nokta
JSON-LD (Google’ın önerisi)Ayrı bir script bloğu olarak head veya body içineGörünür HTML’e dokunmadan yönetilir; iç içe bilgileri ifade etmek kolaydırBloktaki bilgiler sayfadaki metinle sürekli eşleşmelidir
Mikro veriGörünür HTML etiketlerine özellik olarak eklenirİşaretleme doğrudan görünen metnin üzerinde dururTasarım değiştikçe işaretleme kolayca bozulur
RDFaHTML5 etiketlerine özellik olarak eklenirBağlantılı veri projeleriyle uyumludurKüçük ve orta ölçekli sitelerde bakım yükü yüksektir

Google’ın belgesi ayrıca JavaScript veya içerik yönetim sistemi bileşenleriyle sayfaya dinamik olarak eklenen JSON-LD’yi de okuyabildiğini belirtir. Bu, WordPress gibi sistemlerde eklentilerin ürettiği işaretlemenin kullanılabilmesini sağlar.

Sayfa İçeriği

Güvenilir web ajansı: el sıkışan müşteri ve ekip, güven kalkanı illüstrasyonu

Google Hangi Yapısal Veri Türlerini Destekliyor?

Google, desteklediği türleri Arama Merkezi’ndeki arama galerisi sayfasında listeler ve bu liste zamanla değişir; bir türün bugün desteklenmesi, ileride de destekleneceği anlamına gelmez. Kurumsal siteler ve e-ticaret için en sık kullanılan türler şunlardır:

  • Organization (Kuruluş): Logo, resmi ad, adres ve iletişim bilgileri gibi kurum bilgilerini tanımlar; bilgi panellerinde kullanılabilir.
  • LocalBusiness (Yerel işletme): Çalışma saatleri, adres ve yol tarifi gibi fiziksel işletme ayrıntılarını anlatır. Harita görünürlüğünde asıl belirleyici ise Google İşletme Profili’dir; bu konu Google İşletme Profili rehberinde ayrıca ele alınır.
  • Article (Makale): Blog ve haber içeriklerinin başlığını, yazarını, yayın tarihini ve görsellerini tanımlar.
  • BreadcrumbList (İçerik haritası): Sayfanın site hiyerarşisindeki yerini gösterir; arama sonucunda URL yerine kategori yolunun görünmesine yardımcı olabilir.
  • Product (Ürün): Fiyat, stok durumu ve yorum puanı gibi bilgileri aktarır; mağaza sitelerinde ürün sayfalarının temel işaretlemesidir.
  • Event, JobPosting, Recipe gibi alan türleri: Etkinlik, iş ilanı ve yemek tarifi yayınlayan siteler için ayrı zengin sonuç biçimleri sunar.

Listenin değişkenliğine somut bir örnek, Google’ın 2025’te arama sonuç sayfasını sadeleştirme çalışması kapsamında kurs bilgileri, tahmini maaş, eğitim videosu, özel duyuru ve araç listelemesi gibi türlerin desteğini sonlandırmasıdır. Bu yüzden bir şema türüne yatırım yapmadan önce türün güncel galeride yer alıp almadığı kontrol edilir; e-ticarette ürün işaretlemesinin diğer mağaza maddeleriyle birlikte nasıl ele alınacağı e-ticaret SEO kontrol listesinde anlatılır.

SSS ve “Nasıl Yapılır?” Sonuçlarında Ne Değişti?

Sık sorulan sorular ve “nasıl yapılır” zengin sonuçları, yapısal veri denince akla gelen ilk örneklerdi; ancak ikisi de artık sıradan siteler için Google Arama’da gösterilmiyor. Değişiklik iki aşamada gerçekleşti ve her ikisi de Google’ın resmi kanallarında duyuruldu.

Google Search Central Blog’daki 8 Ağustos 2023 tarihli duyuruya göre SSS zengin sonuçları o tarihten sonra yalnızca bilinen, yetkili kamu ve sağlık sitelerinde gösterilmeye başlandı; “nasıl yapılır” sonuçları önce mobilde kaldırıldı, 14 Eylül 2023 tarihli güncellemeyle masaüstünde de gösterilmez oldu ve bu sonuç türü kullanımdan kaldırıldı. Aynı duyuru, kullanılmayan işaretlemenin Arama açısından sorun oluşturmadığını ve proaktif olarak kaldırılmasının gerekmediğini de belirtir.

İkinci aşama 2026’da geldi. Google’ın Arama belge güncellemeleri sayfasında, SSS zengin sonucunun Google Arama’dan 7 Mayıs 2026 itibarıyla kalktığı duyuruldu ve ardından bu özelliğe ait belgeler kaldırıldı. Bu, sayfalardaki sık sorulan sorular bölümlerinin değersiz olduğu anlamına gelmez; okurun sorusunu hızlıca cevaplayan bir SSS bölümü içerik olarak yararlıdır, yalnızca arama sonucunda açılır soru-cevap görünümü sağlamaz.

Sitedeki İşaretlemeyi Birlikte İnceleyelim

WhatsApp üzerinden site adresi paylaşıldığında, sayfalardaki mevcut işaretleme, hatalı veya artık desteklenmeyen türler ve eksik kalan temel türler ücretsiz ön değerlendirmede birlikte incelenir. Zengin sonuç garantisi verilmez; neyin düzeltilmesi gerektiği ve işin kapsamı açıkça paylaşılır.

Schema Markup Nasıl Eklenir? Adım Adım Uygulama

Schema markup, önce sayfa türüne uygun işaretlemenin Google belgesine göre seçilmesi, sonra sayfadaki görünür bilgilerle birebir eşleşen JSON-LD kodunun eklenmesi ve yayından önce ve sonra test edilmesiyle uygulanır. Sıralama aşağıdaki gibidir:

  1. Sayfa türü belirlenir: Ana sayfa için kuruluş, blog yazısı için makale, ürün sayfası için ürün gibi her şablona uygun tür seçilir; aynı işaretleme her sayfaya kopyalanmaz.
  2. Google belgesi okunur: Seçilen türün Arama Merkezi sayfasında zorunlu ve önerilen özellikler kontrol edilir; zorunlu alanı eksik öğeler zengin sonuç için uygun sayılmaz.
  3. Kod hazırlanır: JSON-LD bloğu yazılır ya da SEO eklentisinin ilgili ayarları doldurulur; her değer sayfada görünen bilgiyle aynı olmalıdır.
  4. Zengin Sonuçlar Testi yapılır: Kod veya sayfa adresi araca verilir; kritik hatalar giderilir, uyarılar değerlendirilir.
  5. Schema Markup Validator ile genel kontrol yapılır: Google’ın zengin sonuç için kullanmadığı türler dahil tüm schema.org işaretlemesinin söz dizimi bu araçla doğrulanır.
  6. Yayın sonrası URL Denetleme kullanılır: Search Console’daki araçla Google’ın işaretlemeyi canlı sayfada bulduğu doğrulanır.
  7. Raporlar izlenir: Search Console’daki zengin sonuç durum raporları, tema veya eklenti güncellemesinden sonra ortaya çıkabilecek hataları yakalamak için düzenli kontrol edilir.

Basit bir kuruluş işaretlemesinin JSON-LD hâli aşağıdaki gibidir. Kod, sayfanın head bölümüne bir script bloğu içinde eklenir; örnekteki ad ve adresler temsilidir:

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Örnek Mobilya Atölyesi",
  "url": "https://www.example.com/",
  "logo": "https://www.example.com/logo.png"
}
Şeffaf fiyatlandırma: hesap makinesi ve bütçe planlaması illüstrasyonu

WordPress’te Yapısal Veri Nasıl Eklenir?

WordPress sitelerde yapısal veri çoğunlukla SEO eklentisi üzerinden eklenir; eklenti site geneli için kuruluş bilgisini, yazılar için makale, sayfalar için içerik haritası işaretlemesini otomatik üretir ve sayfa bazında tür seçimine izin verir. Google’ın belgesi de içerik yönetim sistemi kullananların HTML’i doğrudan düzenlemek yerine bir eklenti veya arama motoru ayarları sayfasından yararlanabileceğini belirtir.

Eklenti kullanımında en sık sorun çift işaretlemedir. Tema, sayfa oluşturucu, e-ticaret eklentisi ve SEO eklentisi aynı sayfa için ayrı ayrı işaretleme üretebilir; sonuçta bir ürün sayfasında birbirini tekrar eden veya çelişen iki ürün bloğu oluşur. Kurulumdan sonra birkaç örnek sayfa Zengin Sonuçlar Testi’nden geçirilir ve hangi kaynağın işaretleme ürettiği belirlenip tek kaynağa indirilir.

Eklentinin kapsamadığı türler için JSON-LD, alt tema veya kod parçacığı yöneten bir eklenti aracılığıyla ilgili şablona eklenir. Bu yöntemde kodun sayfadaki içerikle güncel kalması ayrıca takip edilmelidir; fiyatı değişen bir hizmetin işaretlemede eski fiyatla kalması, kalite yönergelerine aykırı bir tutarsızlık yaratır. Yeni kurulan sitelerde bu altyapının baştan doğru kurulması WordPress site yapımı sürecinin parçasıdır.

Zengin Sonuçlar Testi ile Schema Markup Validator Arasındaki Fark

Zengin Sonuçlar Testi, işaretlemenin Google’ın desteklediği zengin sonuçlara uygun olup olmadığını gösterir; Schema Markup Validator ise Google’a özgü kurallara bakmadan schema.org işaretlemesinin genel olarak geçerli olup olmadığını denetler. İki araç birbirinin yerine geçmez, farklı soruları cevaplar.

Google’ın yönergelerine göre Zengin Sonuçlar Testi ve URL Denetleme aracı teknik hataların çoğunu yakalar, ancak kalite yönergeleri otomatik araçlarla kolayca test edilemez. Yani test aracında yeşil sonuç görmek, işaretlemenin sayfadaki içerikle uyumlu olduğunu ya da yanıltıcı olmadığını kanıtlamaz; bu kontrolün bir insan tarafından yapılması gerekir.

Schema Markup Validator, schema.org topluluğu tarafından sunulan bir araçtır ve Google’ın zengin sonuç için kullanmadığı türleri de doğrular. Kuruluş ve kişi gibi genel işaretlemelerin ya da diğer arama motorları ve hizmetler için eklenen özelliklerin söz dizimini kontrol etmek için kullanışlıdır.

Sık Yapılan Hatalar ve Google’ın Kalite Kuralları

Yapısal veride hataların büyük kısmı teknik değil, içerikle ilgilidir: işaretleme sayfanın anlattığından farklı bir şey söylediğinde zengin sonuç kaybedilir, ağır durumlarda manuel işlem uygulanabilir. Google’ın genel yönergeleri ışığında en sık rastlanan hatalar şunlardır:

  • Görünmeyen içeriği işaretlemek: Sayfada yer almayan bir puanı, fiyatı veya soruyu yalnızca kodda vermek yönergelere aykırıdır.
  • İşletmenin kendi hakkındaki yorumlarını yıldız olarak işaretlemek: Google’ın yorum snippet’i belgesine göre yerel işletme ve kuruluş türlerinde yorum işaretlemesi, yalnızca diğer işletmelere dair yorumları derleyen siteler için uygundur; kendi hakkındaki yorumları işleyen işletmeler için ayrı kurallar geçerlidir.
  • Yanlış tür seçmek: Yönergelerdeki örneklerde olduğu gibi, talimat içeriğini yemek tarifi olarak ya da canlı yayını yerel etkinlik olarak işaretlemek alakasız veri sayılır.
  • Zorunlu alanları boş bırakmak: Eksik zorunlu özellik, işaretlemenin zengin sonuca uygunluğunu tamamen ortadan kaldırır.
  • Eskiyen bilgiyi güncellememek: Tarihi geçmiş etkinlik veya değişmiş fiyat, Google’ın zamana duyarlı içerikte zengin sonuç göstermemesine yol açar.
  • İşaretlenen sayfayı taramaya kapatmak: İşaretleme içeren sayfaların robots.txt veya noindex ile engellenmesi, işaretlemenin hiç okunmamasına neden olur.

Teknik denetimin bir parçası olarak işaretlemenin gözden geçirilmesi, hatalı türlerin temizlenmesi ve eksiklerin tamamlanması teknik SEO hizmeti kapsamında yapılır.

Yapısal Verinin Etkisi Nasıl Ölçülür?

Yapısal verinin işe yarayıp yaramadığı, işaretleme eklenen sayfaların öncesi ve sonrası performansı karşılaştırılarak ölçülür; Google da bu yöntemi önerir. Tek bir sayfanın trafiği birçok nedenle dalgalanabildiği için karşılaştırma dikkatle kurulur.

Google’ın önerdiği yaklaşımda Search Console’da birkaç aylık verisi olan, mevsimsellikten fazla etkilenmeyen ve yeterince ziyaret alan sayfalar seçilir. Bu sayfalara işaretleme eklenir, URL Denetleme aracıyla Google’ın işaretlemeyi bulduğu doğrulanır ve sonraki birkaç ay boyunca performans raporu URL’ye göre filtrelenerek tıklama ve tıklama oranı takip edilir. Bu karşılaştırma, bir işaretleme çalışmasının genişletilip genişletilmeyeceğine karar vermek için tahminden daha sağlam bir zemin sunar.

Yapısal Veri Planını Sayfa Türlerine Göre Kuralım

Konuyu yeni öğrenenler için bu rehberdeki tür listesi ve uygulama adımları sağlam bir başlangıçtır. Mevcut işaretlemenin doğru olup olmadığından emin olunamadığında birkaç örnek sayfa üzerinden kısa bir kontrol yapılabilir; uygulamaya geçmek isteyen siteler için tür seçimi, kurulum ve test adımları sayfa sayfa listelenir; fiyat teklifi bu liste üzerinden hazırlanır.

Sıkça Sorulan Sorular

Yapısal veri, sayfadaki bilginin ne olduğunu arama motorlarına schema.org gibi ortak bir sözlükle ve makinenin okuyabileceği biçimde anlatan işaretlemedir. Google bu bilgiyi içeriği anlamak ve desteklediği türlerde zengin sonuç göstermek için kullanabilir.

Google’ın belgeleri schema markup’ı sıralama avantajı olarak değil, zengin sonuçlara uygunluk ve içeriği anlama aracı olarak tanımlar. Doğru işaretlenmiş bir sayfada bile zengin sonucun gösterilmesi garanti edilmez.

Google JSON-LD, mikro veri ve RDFa biçimlerini destekler, ancak uygulaması ve sürdürmesi en kolay olduğu için çoğu durumda JSON-LD önerir. Doğru uygulandıklarında üç biçim de Google için aynı değeri taşır.

SSS zengin sonucu 2023’ten itibaren yalnızca tanınmış devlet ve sağlık sitelerinde gösteriliyordu; Google’ın duyurusuna göre 7 Mayıs 2026 itibarıyla arama sonuçlarından tamamen kalktı. Sayfadaki soru-cevap bölümü okur için yine yararlıdır, ancak arama sonucunda açılır görünüm sağlamaz.

Google’ın zengin sonuçlara uygunluğu için Zengin Sonuçlar Testi, genel schema.org geçerliliği için Schema Markup Validator kullanılır. Yayından sonra canlı sayfa URL Denetleme aracıyla kontrol edilir, zengin sonuç durum raporları da düzenli izlenir.

Temel türler için gerekmez; SEO eklentileri kuruluş, makale ve içerik haritası işaretlemesini otomatik üretebilir. Eklentinin kapsamadığı özel türler için JSON-LD kodu alt tema veya kod parçacığı eklentisiyle eklenir.

Yanıltıcı veya görünmeyen içeriği işaretleyen sayfalara yapısal veriyle ilgili manuel işlem uygulanabilir ve sayfa zengin sonuç görünümünü kaybeder. Google’a göre bu tür bir işlem sayfanın web aramasındaki sıralamasını etkilemez.

Onur Ertem - Onur Freelance Kurumsal Web Tasarım

Onur Ertem

İşletmenizi Dijitalde Güçlendirin! 🚀 Kurumsal web tasarım ve dijital pazarlama çözümleriyle markanızı büyütmeye hazır mısınız? Hemen bize ulaşın, profesyonel desteğimizle dijital dünyada öne çıkın!

Phone-alt Whatsapp

Bizi Arayın

Detaylı bilgi için bizi arayın.

Sizi, Biz Arayalım!

Numaranızı paylaşın sizi, biz arayalım!

Diğer Hizmetlerimiz

Hizmet Bölgeleri

İletişim Bilgileri