Schema Markup (Yapısal Veri) Nedir? Kod Örnekli Kullanım Rehberi (2026)

Kısaca: Schema markup, sayfanızdaki bilgiyi arama motorlarının ve yapay zeka sistemlerinin anlayacağı standart bir sözlükle (schema.org) etiketlemenizi sağlayan koddur. En yaygın biçimi, sayfanın head bölümüne eklenen JSON-LD bloğudur. Doğru kullanıldığında zengin sonuçlar (yıldız, SSS, ürün fiyatı, etkinlik tarihi) kazandırır, varlıkların (kurum, yazar, konum) tanınmasını kolaylaştırır ve yapay zeka özetlerinde kaynak seçimine katkı sağlar. Sıralamayı doğrudan yükseltmez; sayfanın ne olduğunu kesinleştirir.

Bir arama motoru sayfanızdaki "4,8" rakamının bir puan mı, fiyat mı yoksa sürüm numarası mı olduğunu metinden tahmin eder. Schema markup bu tahmini ortadan kaldırır: "Bu bir AggregateRating, değeri 4,8, 127 yorum üzerinden" der. Bu yazı geliştiriciler ve SEO uzmanları için hazırlandı: kavramı kısa tutup doğrudan kopyalanabilir kod örneklerine, test yöntemine ve sahada en sık gördüğümüz hatalara odaklanıyor. Teknik SEO'nun bütününe bakmak için teknik SEO nasıl yapılır rehberimize, sayfa içi öğeler için on-page SEO nedir yazımıza bakabilirsiniz.

Schema Markup Nedir, Neden Önemlidir?

Schema.org, 2011'de Google, Microsoft, Yahoo ve Yandex'in ortak kurduğu açık bir sözlüktür. Yüzlerce "tip" (Article, Product, LocalBusiness, Event, Recipe) ve her tipin "özellikleri" (name, author, datePublished, price) tanımlıdır. Sayfanıza bu sözlükle yazılmış bir blok eklediğinizde, arama motoru sayfayı okumakla kalmaz, anlamını da alır.

2026'da yapısal verinin üç somut getirisi var:

Bir uyarı: Google, yapısal verinin doğrudan sıralama sinyali olmadığını açıkça belirtir. Etkisi dolaylıdır; zengin sonuç tıklamayı artırır, varlık tanıma güveni artırır. Şema ekleyip sıralama beklemek, sahada en sık gördüğümüz yanlış beklenti.

Hangi Biçim: JSON-LD, Microdata, RDFa?

Üç biçim de geçerli; ancak karar netleşmiş durumda.

Bu yazıdaki tüm örnekler JSON-LD. Next.js, WordPress veya başka bir altyapı fark etmez; blok sayfanın HTML çıktısında yer aldığı sürece çalışır.

Kod Örnekleri: Dört Temel Şema

Aşağıdaki örnekler olduğu gibi kopyalanıp alanları değiştirilerek kullanılabilir. Her örnek Google'ın zengin sonuç dokümantasyonundaki zorunlu ve önerilen alanları içerir.

1. Organization: Kurum kimliği

Sitenin tamamında, tercihen her sayfada yer alır. "@id" alanı, diğer şemaların bu kuruma referans vermesini sağlar.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.ornekajans.com/#organization",
  "name": "Örnek Dijital Ajans",
  "url": "https://www.ornekajans.com/",
  "logo": "https://www.ornekajans.com/logo.png",
  "foundingDate": "2016",
  "telephone": "+90-212-000-00-00",
  "email": "info@ornekajans.com",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Örnek Mah. Örnek Sk. No:1",
    "addressLocality": "Ataşehir",
    "addressRegion": "İstanbul",
    "postalCode": "34768",
    "addressCountry": "TR"
  },
  "sameAs": [
    "https://www.linkedin.com/company/ornekajans",
    "https://www.instagram.com/ornekajans"
  ],
  "founder": { "@id": "https://www.ornekajans.com/hakkimizda/#kurucu" }
}

2. Article ve BlogPosting: İçerik ve yazar

Blog yazıları ve rehberler için. Yazar bir Person olmalı ve mümkünse kendi "@id"si ile yazar sayfasına bağlanmalı; kurum adını Person olarak yazmak sık yapılan bir hatadır.

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "mainEntityOfPage": "https://www.ornekajans.com/blog/schema-markup-nedir/",
  "headline": "Schema Markup Nedir? Kod Örnekli Kullanım Rehberi",
  "description": "Yapısal verinin ne olduğu ve nasıl uygulanacağı.",
  "image": "https://www.ornekajans.com/images/schema-kapak.webp",
  "datePublished": "2026-10-07T09:00:00+03:00",
  "dateModified": "2026-10-07T09:00:00+03:00",
  "inLanguage": "tr-TR",
  "wordCount": 1400,
  "author": {
    "@type": "Person",
    "@id": "https://www.ornekajans.com/yazarlar/ayse-yilmaz/#person",
    "name": "Ayşe Yılmaz",
    "jobTitle": "Teknik SEO Uzmanı",
    "url": "https://www.ornekajans.com/yazarlar/ayse-yilmaz/",
    "sameAs": ["https://www.linkedin.com/in/ayseyilmaz"]
  },
  "publisher": { "@id": "https://www.ornekajans.com/#organization" }
}

3. FAQPage: Soru-cevap bölümleri

Sayfada görünen SSS bölümüyle birebir aynı soru ve cevapları içermelidir. Google, 2023'ten beri SSS zengin sonucunu yalnızca kamu ve sağlık otoritesi sitelerinde gösteriyor; buna rağmen FAQPage, sayfanın soru-cevap yapısını arama motorlarına ve yapay zeka sistemlerine net biçimde aktardığı için kullanılmaya değer.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Schema markup sıralamayı etkiler mi?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Doğrudan etkilemez. Zengin sonuçlar tıklama oranını artırır ve varlık tanımayı güçlendirir; sıralama etkisi dolaylıdır."
      }
    },
    {
      "@type": "Question",
      "name": "JSON-LD bloğu head içinde mi olmalı?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Head veya body içinde olabilir. Google ikisini de okur; önemli olan bloğun sayfanın HTML çıktısında bulunmasıdır."
      }
    }
  ]
}

4. LocalBusiness: Yerel işletme

Fiziksel adresi olan her işletme için. Alt tipler (Dentist, Restaurant, LegalService, ProfessionalService) genel LocalBusiness yerine tercih edilmeli; Google alt tipi daha iyi sınıflandırır. Koordinatlar ve çalışma saatleri zengin sonucu ve harita eşleşmesini güçlendirir.

{
  "@context": "https://schema.org",
  "@type": "Dentist",
  "@id": "https://www.ornekklinik.com/#localbusiness",
  "name": "Örnek Diş Kliniği",
  "image": "https://www.ornekklinik.com/klinik.webp",
  "url": "https://www.ornekklinik.com/",
  "telephone": "+90-216-000-00-00",
  "priceRange": "₺₺",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Örnek Cad. No:10",
    "addressLocality": "Kadıköy",
    "addressRegion": "İstanbul",
    "postalCode": "34710",
    "addressCountry": "TR"
  },
  "geo": { "@type": "GeoCoordinates", "latitude": 40.9900, "longitude": 29.0300 },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "18:00"
    }
  ],
  "sameAs": ["https://www.instagram.com/ornekklinik"]
}

AggregateRating alanını yalnızca sayfada gerçekten görünen, kendi sitenizde toplanmış yorumlar için ekleyin. Google İşletme Profili'ndeki yorumları kendi şemanıza yazmak Google'ın yönergelerine aykırıdır ve manuel işlem sebebidir.

Hangi Sayfaya Hangi Şema?

Birden fazla şema aynı sayfada olabilir; ayrı script blokları ya da tek blokta "@graph" dizisi kullanılır. "@id" referanslarıyla şemalar birbirine bağlanır: BlogPosting'in publisher'ı Organization'ı, Organization'ın founder'ı Person'ı gösterir. Bu bağlantılar, E-E-A-T sinyallerinin makine tarafından okunabilir hali olduğu için 2026'da şema çalışmasının en değerli kısmıdır.

Test ve Doğrulama

Şemayı eklemek işin yarısı. Doğrulama rutini:

1. Google Zengin Sonuç Testi: Sayfanın URL'sini veya kodunu yapıştırın. Hangi zengin sonuçlara uygun olduğunu ve eksik zorunlu alanları gösterir.
2. Schema.org Doğrulayıcı: Google'ın zengin sonuç kapsamı dışındaki şemaları (Organization, Person ilişkileri) sözdizimi açısından denetler.
3. Search Console, Geliştirmeler bölümü: Site genelindeki şema hatalarını ve uyarılarını toplu gösterir; yeni şema ekledikten sonra birkaç gün içinde burada izleyin.
4. Canlı HTML kontrolü: Kaynak kodunu görüntüleyip bloğun gerçekten çıktıda olduğunu doğrulayın. Özellikle JavaScript ile sonradan eklenen şemalar bazı tarayıcılar tarafından görülmez.

En Sık Yapılan 8 Hata

1. Görünmeyen içeriği işaretlemek. Sayfada olmayan SSS, yorum veya fiyatı şemaya yazmak Google'ın yapısal veri yönergelerini ihlal eder.
2. Kurumu Person olarak yazmak. Yazar alanına şirket adını Person tipiyle koymak varlık karışıklığı yaratır. Kurum Organization, yazar Person olmalı.
3. Tarihleri güncellemek ama içeriği güncellememek. dateModified her yayında otomatik değişiyorsa güven sinyali olmaktan çıkar.
4. Genel tip kullanmak. Dentist yerine LocalBusiness, BlogPosting yerine Thing. Mümkün olan en özel tipi seçin.
5. Şemalar arasında bağlantı kurmamak. "@id" olmadan her şema izole kalır; Organization, Person ve Article birbirini görmez.
6. Çakışan bilgiler. Şemadaki telefon ile sayfadaki telefon farklıysa ikisi de güvenilirliğini kaybeder.
7. Eklenti çakışması. WordPress'te SEO eklentisi ve tema aynı sayfaya iki Organization bloğu basabilir. Tek kaynak bırakın.
8. Test etmeden yayınlamak. Eksik zorunlu alan içeren şema zengin sonuç üretmez ve Search Console'da hata olarak birikir.

Sonuç: Sayfanın Ne Olduğunu Tahmine Bırakmayın

Schema markup, sayfanızın ne anlattığını arama motorlarına ve yapay zeka sistemlerine kesin bir dille söylemenin standart yoludur. Dört temel şemayı doğru kurmak, şemaları "@id" ile birbirine bağlamak ve yalnızca sayfada görünen bilgiyi işaretlemek, bu alandaki işin yüzde doksanını oluşturur. Gerisi düzenli test ve Search Console takibidir.

Sitenizin mevcut şema yapısını denetlemek ve varlık bağlantılarını kurmak teknik SEO hizmetimizin parçasıdır. Yerel işletme şemaları ve harita görünürlüğü için yerel SEO çözümlerimize bakabilir, denetim için bizimle iletişime geçebilirsiniz.

Kaynaklar: Google Search Central, "Structured data general guidelines" ve zengin sonuç dokümantasyonu (Article, FAQPage, LocalBusiness, Organization); Google Search Central Blog, Ağustos 2023 SSS ve HowTo zengin sonuç değişikliği duyurusu; schema.org tip ve özellik tanımları.