Schema (yapılandırılmış veri) nedir, nasıl eklenir?

JSON-LD’nin ne olduğundan küçük bir işletme sitesinin ihtiyaç duyduğu türlere, Google’ın artık göstermediği özelliklerden test ve sık hatalara.

· 11 dk okumaSEO

Kısa cevap

Schema ya da yapılandırılmış veri, bir sayfanın ne anlattığını Google’a standart bir biçimde bildiren koddur; Google’ın önerdiği biçim JSON-LD’dir. Doğru işaretleme zengin sonucu garanti etmez. Yalnızca sayfada görünen bilgiyi işaretleyin ve yayından önce Zengin Sonuçlar Testi’yle doğrulayın.

Şöyle düşünün: küçük bir mobilya atölyesinin sahibi, sitesine bir eklenti kuruyor ve her sayfaya soru-cevap işaretlemesi ekletiyor. Arama sonuçlarında açılır soru kutuları çıkacağını umuyor. Aylar geçiyor, hiçbir şey değişmiyor. Nedeni basit: Google, FAQ zengin sonucunun 7 Mayıs 2026’dan itibaren Arama’da görünmeyeceğini duyurdu. Schema (yapılandırılmış veri) nedir, nasıl eklenir sorusunun pratik tarafı, bu yüzden önce hangi türün hâlâ işe yaradığını bilmekle başlıyor. Bu yazıda tanımı, doğru biçimi, küçük bir işletme sitesinin gerçekte ihtiyaç duyduğu türleri, ekleme ve test adımlarını ve sık hataları sırayla anlatıyoruz.

Schema (yapılandırılmış veri) nedir?

Google’ın tanımına göre yapılandırılmış veri, bir sayfa hakkındaki bilgiyi vermek ve sayfa içeriğini sınıflandırmak için kullanılan standart bir biçimdir. Google bunu sayfanın anlamına dair açık ipuçları olarak kullanır; ayrıca kişiler, kitaplar ya da şirketler gibi, işaretlemede geçen varlıklar hakkında bilgi toplamak için de kullanır. Bazı türlerde bu veri, aramada “zengin sonuç” (rich result) denen daha ayrıntılı bir görünüme de olanak tanır. Çoğu işaretleme schema.org sözlüğünü kullanır; yine de Google, Arama davranışı için kesin kaynak olarak kendi Search Central belgelerini gösteriyor. Kısa terim açıklaması için yapılandırılmış veri sözlük maddesine bakabilirsiniz.

Bilmeniz gereken ilk sınır Google’ın genel yönergelerinde yazıyor: işaretleme Zengin Sonuçlar Testi’ne göre doğru olsa bile Google verinin arama sonuçlarında görüneceğini garanti etmez. Yapılandırılmış veri bir özelliğin görünmesini mümkün kılar, görüneceğini garanti etmez. Google, arama geçmişi, konum ve cihaz gibi birçok değişkene bağlı olarak başka bir özelliği ya da düz bir metin sonucunu daha uygun bulabilir. Yönergeler ayrıca işaretlemenin sayfanın ana içeriğini temsil etmemesini, yanıltıcı olmasını ya da kullanıcıdan gizlenen içeriğe dayanmasını da gösterilmeme nedenleri arasında sayar. Yapılandırılmış veri sorunu nedeniyle uygulanan manuel işlem de yalnızca sayfanın zengin sonuç olarak görünme uygunluğunu kaldırır; Google’a göre sayfanın web aramasındaki sıralamasını etkilemez.

Bu yüzden schema’yı sıralama vaadi olarak düşünmeyin; sayfanın ne olduğunu makineye doğru anlatma işi olarak düşünün. Teknik denetimdeki yeri için teknik SEO kontrol listesindeki yapılandırılmış veri maddesine de bakın.

JSON-LD: Google’ın önerdiği biçim

Google Arama üç biçimi destekler: JSON-LD, Microdata ve RDFa. Google’a göre işaretleme geçerli ve belgeye uygun olduğu sürece üçü de eşit derecede kabul edilir. Yine de siteniz izin veriyorsa JSON-LD’yi öneriyor, çünkü büyük ölçekte uygulaması ve bakımı en kolay biçim bu. JSON-LD, sayfanın <head> ya da <body> bölümündeki bir <script> etiketine yazılır. İşaretleme görünen metnin arasına karışmaz; JSON-LD sayfaya JavaScript ya da CMS’in bileşenleriyle sonradan eklense bile Google onu okuyabilir.

Küçük bir işletme sitesi hangi türlere ihtiyaç duyar?

Google, desteklediği işaretleme özelliklerini tek bir galeride listeler. Aşağıdaki tabloda küçük bir işletme sitesinin sık karşılaştığı beş tür var; ikinci sütundaki sayfa eşleşmesi bizim önerimizdir, üçüncü sütun Google’ın galerideki tanımını özetler.

Tür Hangi sayfada (bizim önerimiz) Google galerisinde tanımı
Organization Ana sayfa Logo, yasal ad, adres, iletişim bilgisi ve şirket tanımlayıcıları gibi kuruluş bilgisi; bilgi panellerinde ve başka görsel öğelerde görünebilir
LocalBusiness İşletme ya da şube sayfası Çalışma saatleri, puan, yol tarifi ve randevu ya da sipariş eylemleri gibi, Google bilgi panelinde gösterilen işletme ayrıntıları
Article Blog yazıları Haber, spor ya da blog yazısının, başlık ve küçük resimden büyük görseller gibi özelliklerle gösterilmesi
Product Ürün sayfası Fiyat, stok durumu ve yorum puanı gibi ürün bilgisi
BreadcrumbList İç sayfalar Sayfanın site hiyerarşisindeki yerini gösteren gezinme yolu

Her sayfaya her türü eklemek gerekmez. Yerel işletmeler için LocalBusiness ayrıntısını yerel SEO rehberimizde, ürün sayfasındaki Product işaretlemesini ürün sayfası yazımızda anlattık; burada tekrarlamıyoruz. Hizmet sayfamızda, e-ticaret SEO kalemleri arasında ürün şeması da sayılıyor.

Google’ın bugün artık göstermediği özellikler

Eski rehberlerin çoğu hâlâ FAQ ve HowTo işaretlemesini öneriyor. Google’ın Search Central değişiklik günlüğü bugün şunu gösteriyor:

Özellik Değişiklik günlüğündeki kayıt
FAQ Eylül 2023: özellik yalnızca iyi bilinen, otoriter devlet ve sağlık sitelerinde gösterilir. 8 Mayıs 2026: 7 Mayıs 2026’dan itibaren Arama’da görünmeyeceği duyuruldu. Haziran 2026: belge, özellik artık gösterilmediği için kaldırıldı
HowTo Eylül 2023: belge, sonuç masaüstünde ve mobilde artık gösterilmediği için kaldırıldı
Course info, estimated salary, learning video, special announcement, vehicle listing (İngilizce belgedeki adlarıyla) Eylül 2025: belgeleri, bu türler artık gösterilmediği için kaldırıldı

FAQ ve HowTo, Google’ın desteklenen özellikler galerisinde de yer almıyor. Buradan çıkardığımız sonuç şu (bu bizim yorumumuz): bu işaretlemeyi yalnızca zengin sonuç almak için eklemenin bugün bir gerekçesi yok. Sayfadaki soru-cevap bölümü ise okuyucu için yazıldığından yerinde durabilir. O bölümü nasıl yazacağınızı SSS sayfası rehberimizde anlattık. Mevcut işaretlemeyi silmeniz gerektiğini söyleyen bir ifadeyi okuduğumuz sayfalarda görmedik.

Schema nasıl eklenir: 5 adım

Şekil sırayı özetliyor; ayrıntılar aşağıda.

Yapılandırılmış veri eklemenin beş adımı: türü seçmek, görünen içeriği hazırlamak, JSON-LD’yi eklemek, Zengin Sonuçlar Testi’nde denemek, yayınlayıp izlemek 1 Sayfaya uyan türü seçin 2 Görünen içeriği hazırlayın 3 JSON-LD’yi ekleyin 4 Zengin Sonuçlar Testi’nde deneyin 5 Yayınlayın ve izleyin URL Denetleme ve zengin sonuç raporları Yapılandırılmış veri eklemenin beş adımı: türü seçmek, görünen içeriği hazırlamak, JSON-LD’yi eklemek, Zengin Sonuçlar Testi’nde denemek, yayınlayıp izlemek 1 Sayfaya uyan türü seçin 2 Görünen içeriği hazırlayın 3 JSON-LD’yi ekleyin 4 Zengin Sonuçlar Testi’nde deneyin 5 Yayınlayın ve izleyin URL Denetleme ve zengin sonuç raporları
Şekil: Yapılandırılmış veri sırayla türün seçilmesi, görünen içeriğin hazırlanması, JSON-LD’nin eklenmesi, testi ve yayından sonra izlenmesiyle tamamlanır.

1. Sayfaya uyan türü seçin

Önce Google’ın galerisinden, sayfanın gerçekte ne olduğuna uyan türü seçin. Google’ın yönergesi, schema.org’daki en belirli uygun tür ve özellik adlarını kullanmanızı ister. Uygunsuz işaretleme örneği olarak şunları verir: talimat sayfasını tarif diye işaretleyen bir marangozluk sitesi ya da yayınları yerel etkinlik diye işaretleyen bir canlı yayın sitesi. Belirli bir türün zorunlu özelliklerini eksiksiz doldurmanız gerekir; eksikse öğe zengin sonuca uygun olmaz. Google, önerilen özelliklerin hepsini eksik ve hatalı doldurmaktansa daha azını eksiksiz ve doğru vermenin daha önemli olduğunu da yazar.

2. Görünen içeriği hazırlayın

İşaretleyeceğiniz bilgi önce sayfada okuyucuya görünür olmalı. Google’ın yönergesi açık: doğru olsa bile ziyaretçiye görünmeyen bilgiyi işaretlemeyin. İşaretleme bir sanatçıyı anlatıyorsa sayfanın metni de aynı sanatçıyı anlatmalı. Yalnızca işaretleme tutmak için boş sayfalar da oluşturmayın. İşaretlemeyi, anlattığı sayfaya koyun; sahte yorum ya da sayfanın odağıyla ilgisiz içerik işaretlemeyin. İşaretlemedeki görsellerin adresleri taranabilir ve dizine eklenebilir olmalı.

3. JSON-LD’yi ekleyin

Aşağıda, uydurma bir atölyenin ana sayfasına konabilecek en yalın Organization örneği var. Alanlar, o sayfada görünen bilgiyle aynı olmalı; sitede yazmayan bir e-postayı eklemeyin. sameAs için Google, bu özelliği ve schema.org’un diğer verilerini genel olarak kullanabileceğini yazıyor.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Örnek Atölye",
  "url": "https://www.example.com",
  "logo": "https://www.example.com/images/logo.png",
  "email": "iletisim@example.com",
  "sameAs": ["https://social.example.com/ornek-atolye"]
}
</script>

Kodu eklemenin üç yolu var. Aşağıdaki tabloda Google’ın belgelerinin her biri için söylediği şeyleri topladık.

Yöntem Google’ın belgelerinde yazanlar
Elle (şablona ya da sayfaya) JSON-LD’nin kurulumu ve bakımı en kolay biçim olduğu belirtilir. Sunucu tarafı oluşturma kullanıyorsanız JSON-LD’yi oluşturulan çıktıya ekleyebilirsiniz.
CMS ya da eklenti Wix, WordPress, Shopify gibi sistemlerde HTML’i doğrudan düzenleyemeyebilirsiniz; CMS’in arama motoru ayarları sayfası ya da yapılandırılmış veri eklentisi olabilir. Aramak için “wordpress structured data plugin” gibi ifadeler öneriliyor.
Google Tag Manager Kapsayıcıya Özel HTML etiketi eklenir, JSON-LD içine yapıştırılır ve kapsayıcı yayınlanır. Sayfadaki bilgiyi GTM’e kopyalamak yerine değişkenlerle okumanız önerilir; kopyalamak, sayfa ile işaretleme arasında uyuşmazlık riskini artırır.

Aynı belge, Product işaretlemesinde dinamik üretimin Shopping taramalarını daha seyrek ve daha az güvenilir yapabileceğini, fiyat ve stok gibi hızlı değişen bilgide bunun sorun olabileceğini de belirtiyor. Bu yüzden ürün sayfalarında JSON-LD’yi sunucu tarafında oluşturmak bizim tercihimiz (bu bizim yorumumuz). Seçenekleri ayrıntısıyla görmek isterseniz CMS seçimi ve Google Tag Manager kurulumu yazılarına bakın.

4. Zengin Sonuçlar Testi’nde deneyin

Google, yapılandırılmış veriyi doğrulamak için Zengin Sonuçlar Testi’ni kolay ve yararlı bir araç olarak tanımlar; bazı durumlarda özelliğin Arama’daki önizlemesini de gösterir. Geliştirme sırasında bu testi kullanın ve hataları düzeltin. Testin sınırını da unutmayın: Google, yapılandırılmış verinin Zengin Sonuçlar Testi’nin yakalayamadığı biçimde yanlış olabileceğini yazıyor. Test geçse bile sayfadaki metinle işaretleme uyuşuyor mu, kendiniz bakın.

5. Yayınlayın ve izleyin

Yayına aldıktan sonra URL Denetleme aracıyla Google’ın yapılandırılmış veriyi bulduğunu doğrulayın. Sayfayı robots.txt, noindex ya da başka bir erişim kısıtıyla Googlebot’tan gizlemeyin; yönergeler bunu açıkça söyler. Google, yayından sonra Search Console’daki zengin sonuç raporlarına bakmayı öneriyor, çünkü sayfalar şablon ya da sunum sorunları yüzünden yayından sonra bozulabilir. Manuel işlem olup olmadığını Manuel İşlemler raporundan görebilirsiniz. Etkisini ölçmek isterseniz Google, işaretlemesi olmayan birkaç sayfaya işaretleme ekleyip Search Console’daki Performans raporunda öncesiyle sonrasını karşılaştırmayı öneriyor ve sayfa görüntülemelerinin başka nedenlerle de değişebileceğini hatırlatıyor.

Schema’da sık yapılan hatalar

  • Görünmeyen bilgiyi işaretlemek. Sayfada olmayan fiyat, yorum puanı ya da etkinlik, yönergeye aykırıdır.
  • Sahte ya da konuyla ilgisiz yorum işaretlemek. Google, gerçek kullanıcılara ait olmayan yorum ve puanların manuel işleme yol açabileceğini yazar.
  • FAQ ve HowTo’yu zengin sonuç umuduyla eklemek. Yukarıdaki tablo bunun bugün karşılığı olmadığını gösteriyor.
  • Zorunlu özellikleri atlamak. Zorunlu özelliği eksik öğe zengin sonuca uygun olmaz.
  • Sayfayı Googlebot’tan gizlemek. Google, yapılandırılmış veri içeren sayfaları robots.txt, noindex ya da başka erişim denetimleriyle engellememenizi ister.
  • Tag Manager’da bilgiyi elle kopyalamak. Örneğin sayfada fiyat değişir, GTM’deki eski kalır.
  • Eski sözlükte kalmak. Google, data-vocabulary.org işaretlemesinin zengin sonuç için artık uygun olmadığını belirtiyor.
  • Testi geçmeyi garanti saymak. Geçerli işaretleme sonucu garanti etmez.

Sık sorulanlar

Schema eklemek sıralamayı yükseltir mi?

Okuduğumuz Google sayfalarında böyle bir ifade yok. Belgeler yapılandırılmış verinin Google’ın sayfayı anlamasına yardım ettiğini ve zengin sonucu mümkün kıldığını söylüyor; sonucu garanti etmiyor. Manuel işlem de yalnızca zengin sonuç uygunluğunu etkiler, sıralamayı etkilemez.

Sitemde FAQ işaretlemesi var, silmeli miyim?

Google FAQ özelliğini artık göstermiyor ve belgesini kaldırdı. Silme zorunluluğu getiren bir ifade okuduğumuz sayfalarda yok. Bizim önerimiz yeni sayfalara bunu zengin sonuç için eklememeniz; mevcut olanı sonraki bakımda sadeleştirebilirsiniz.

Tag Manager ile schema eklemek sorun olur mu?

Google’ın belgesi bunu bir yol olarak anlatıyor. Dikkat noktası, sayfadaki bilgiyi değişkenlerle okumanız, GTM’de kopyalamamanızdır; Product işaretlemesinde ise dinamik üretimin Shopping taramalarını etkileyebileceği belirtiliyor.

Bugün kendi başınıza yapabileceğiniz kontrol

Ana sayfanızın adresini Zengin Sonuçlar Testi’ne yapıştırın ve hangi türlerin bulunduğuna bakın. Bulunan her alanı, sayfada gözle gördüğünüz bilgiyle karşılaştırın: ad, logo, telefon, e-posta aynı mı? Hiçbir şey bulunmadıysa yukarıdaki Organization örneğini kendi bilgilerinizle uyarlayıp aynı testte deneyin. İşaretlemeyi birlikte planlamak isterseniz SEO hizmetimize bakabilirsiniz.

Kaynaklar

Bu yazı genel bilgi vermek için hazırlandı; hukuki, mali ya da teknik danışmanlık yerine geçmez. Platformlar, kuralları ve mevzuat zamanla değişir; 14 Kasım 2026 tarihinden bu yana değişmiş ya da küçük hatalar içeren bilgiler olabilir. İşinizle ilgili bir karar vermeden önce güncel resmi kaynakları kontrol edin ya da bize yazın.

Diğer yazılar

Projenizi
anlatın.

Formu doldurun ya da doğrudan yazın; görüşme gününü birlikte belirleriz.

İlk görüşmeyi Detmore’un kurucusu Deniz Sezer yapar.

İlk görüşme ücretsiz · Bir iş gününde yanıt · 2 ila 3 günde yazılı teklif · NDA hazır

Neye ihtiyacınız var? birden fazla seçebilirsiniz

Ad, e-posta ve telefon zorunludur.

İletişim

Bir iş günü içinde dönüyoruz.