İçeriğe geç
Araçlar Teklif Al
SEO

Structured Data ve Schema Markup: JSON-LD Kılavuzu 2026

15 Haziran 2026 Kerem Kırbıyık 9 dk okuma
Structured data ve schema markup JSON-LD kodunu gösteren, rich results kavramını anlatan teknik SEO illüstrasyonu

Google bir sayfayı okuduğunda iki şeyi anlamaya çalışıyor: sayfanın ne hakkında olduğunu ve içeriğin ne tür bilgi sunduğunu. İkinci soruyu yanıtlamanın en doğrudan yolu, sayfaya makine tarafından okunabilir bir etiket sistemi eklemek.

Structured data (yapılandırılmış veri), web sayfasına eklenen ve arama motorlarına içeriğin türü, kapsamı ve ilişkileri hakkında standart bilgi sunan kodlama sistemidir. Schema markup ise bu bilgiyi tanımlamak için kullanılan kelime dağarcığıdır; Schema.org tarafından geliştirilen ve Google, Bing, Yahoo gibi büyük motorların ortaklaşa desteklediği evrensel standart.

Bu kılavuzda yapılandırılmış verinin ne olduğunu, hangi schema türlerinin ne işe yaradığını, JSON-LD formatında nasıl yazıldığını ve hataların nasıl tespit edildiğini adım adım ele alıyorum. Teknik SEO’nun genel çerçevesini görmek için teknik SEO rehberimize bakabilirsiniz.

Structured data nedir ve neden önemli?

Structured data, HTML’e eklenen ek bir anlam katmanıdır. Normal HTML bir paragrafın metin içerdiğini söyler. Structured data ise o metnin bir ürün fiyatı, bir film notu veya bir tarif pişirme süresi olduğunu makineye anlatır.

Neden önemli?

Rich results (zengin sonuçlar). Doğru schema kullanan sayfalar Google SERP’inde standart mavi bağlantının ötesinde görsel öğeler kazanıyor: yıldız puanları, SSS açılır listesi, fiyat ve stok bilgisi, breadcrumb, etkinlik tarihi. Bu zengin sonuçlar tıklama oranını belirgin biçimde artırıyor.

AI motorlarında kaynak önceliği. Schema, yapay zeka motorlarının içeriği doğru sınıflandırmasına yardımcı oluyor. FAQPage schema’sı olan bir içerik, Perplexity veya Google AI Overviews tarafından soru-cevap formatında daha sık kullanılıyor. GEO perspektifinden schema’nın önemini GEO nedir rehberimiz ayrıntıyla açıklıyor.

Sesli arama ve AEO uyumu. Speakable ve FAQPage schema, sesli yanıtların kaynağı olarak seçilme olasılığını artırıyor.

Knowledge Graph. Organization schema ile Google’ın bilgi grafındaki marka kaydınız güçleniyor; arama sonuçlarında marka paneli görünme ihtimali artıyor.

JSON-LD: önerilen format

Structured data üç farklı formatta yazılabilir: JSON-LD, Microdata ve RDFa. Google resmi olarak JSON-LD’yi öneriyor. Sebebi basit: HTML içeriğine dokunmadan, sayfanın <head> veya <body> bölümüne ayrı bir <script> bloğu olarak eklenebiliyor. Bakımı kolay, hata riski düşük.

JSON-LD’nin temel yapısı:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Makale başlığı",
  "author": {
    "@type": "Person",
    "name": "Yazar adı"
  },
  "datePublished": "2026-06-12"
}
</script>

Her schema bloğu @context (her zaman https://schema.org) ve @type (schema türü) ile başlıyor. Geri kalanı türe göre değişen özellikler.

En değerli schema türleri ve kullanım alanları

Article ve BlogPosting

Blog yazıları ve haber makaleleri için. Rich result doğrudan üretmese de Google’ın içeriği doğru anlaması ve E-E-A-T sinyallerini işlemesi için önemli.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Core Web Vitals Nedir? 2026 Optimizasyon Rehberi",
  "description": "LCP, INP ve CLS metriklerini açıklayan kapsamlı rehber.",
  "image": "https://seobify.com/images/blog-gorseller/core-web-vitals.webp",
  "author": {
    "@type": "Person",
    "name": "Kerem Kırbıyık",
    "url": "https://seobify.com/hakkimizda/"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Seobify",
    "logo": {
      "@type": "ImageObject",
      "url": "https://seobify.com/logo.svg"
    }
  },
  "datePublished": "2026-06-12",
  "dateModified": "2026-06-12"
}
</script>

Kritik alanlar: headline, author, datePublished, dateModified, image. Eksik bırakılan alanlar rich result kalitesini düşürüyor.

FAQPage

Sıkça Sorulan Sorular bölümü olan her sayfa için. Google SERP’inde doğrudan SSS açılır listesi olarak görünme şansı veriyor. AEO ve GEO için de kritik.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Schema markup SEO'ya nasıl katkı sağlar?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Schema markup, Google'ın içeriği doğru anlamasına yardımcı olarak rich results kazanma olasılığını artırır ve AI motorlarında kaynak olarak seçilme şansını yükseltir."
      }
    },
    {
      "@type": "Question",
      "name": "JSON-LD nerede eklenir?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sayfanın <head> veya <body> bölümüne <script type='application/ld+json'> etiketi içinde eklenir."
      }
    }
  ]
}
</script>

Dikkat: Schema’daki soru ve cevaplar, sayfanın görünür içeriğiyle birebir eşleşmeli. Schema’ya ekleyip sayfada göstermemek Google’ın spam politikasına aykırı.

Organization

Marka kimliğini ve iletişim bilgilerini standartlaştırıyor. Knowledge Graph’a katkı sağlıyor. Genellikle site genelinde, <head> bölümüne ekleniyor.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Seobify",
  "url": "https://seobify.com",
  "logo": "https://seobify.com/logo.svg",
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer service",
    "email": "info@seobify.com"
  },
  "sameAs": [
    "https://twitter.com/seobify",
    "https://www.linkedin.com/company/seobify"
  ]
}
</script>

sameAs alanı, markanın sosyal medya profillerini ve diğer tanımlayıcı URL’lerini bağlayarak Google’ın marka kimliğini doğrulamasına yardımcı oluyor.

LocalBusiness

Yerel işletmeler için. Google Haritalar ve yerel arama sonuçlarında görünürlük için kritik. NAP (Name, Address, Phone) bilgilerini yapılandırıyor.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Seobify SEO Danışmanlığı",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Örnek Mahallesi, Örnek Caddesi No:1",
    "addressLocality": "İstanbul",
    "addressRegion": "İstanbul",
    "postalCode": "34000",
    "addressCountry": "TR"
  },
  "telephone": "+90-212-000-0000",
  "url": "https://seobify.com",
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "18:00"
    }
  ]
}
</script>

Sayfa hiyerarşisini Google’a anlatıyor. SERP’te URL yerine breadcrumb görünümü sağlıyor. Kullanıcıya sitenin yapısını gösteriyor; CTR artışına katkı sağlıyor.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Ana Sayfa",
      "item": "https://seobify.com/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog",
      "item": "https://seobify.com/blog/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Schema Markup Kılavuzu",
      "item": "https://seobify.com/blog/structured-data-schema-markup-json-ld/"
    }
  ]
}
</script>

HowTo

Adım adım rehber içerikleri için. Her adım ayrı tanımlanabiliyor. SERP’te adımların listelendiği zengin sonuç formatı kazandırabiliyor.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Schema Markup Nasıl Eklenir?",
  "step": [
    {
      "@type": "HowToStep",
      "position": 1,
      "name": "Schema türünü belirle",
      "text": "İçeriğinizin türüne göre Article, FAQPage veya Organization gibi uygun schema tipini seçin."
    },
    {
      "@type": "HowToStep",
      "position": 2,
      "name": "JSON-LD kodunu yazın",
      "text": "Schema.org dokümantasyonunu referans alarak gerekli alanları doldurun."
    },
    {
      "@type": "HowToStep",
      "position": 3,
      "name": "Sayfanın head bölümüne ekleyin",
      "text": "<script type='application/ld+json'> etiketi içinde sayfaya ekleyin."
    },
    {
      "@type": "HowToStep",
      "position": 4,
      "name": "Google Rich Results Test ile doğrulayın",
      "text": "Google'ın Rich Results Test aracını kullanarak schema'nın hatasız çalıştığını doğrulayın."
    }
  ]
}
</script>

Product ve Review

E-ticaret sayfaları için. Ürün adı, fiyat, stok durumu ve müşteri yorumu puanı SERP’te doğrudan görünebiliyor. Yanlış kullanım Google cezasına yol açabiliyor; yalnızca gerçek ürün sayfalarında kullanın.

WebSite ve SearchAction

Ana sayfa için. Sitelink arama kutusunun SERP’te görünmesini sağlayabiliyor.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "Seobify",
  "url": "https://seobify.com",
  "potentialAction": {
    "@type": "SearchAction",
    "target": "https://seobify.com/?s={search_term_string}",
    "query-input": "required name=search_term_string"
  }
}
</script>

Schema doğrulama araçları

Google Rich Results Test

search.google.com/test/rich-results adresinde ücretsiz. URL veya HTML kodu yapıştırarak schema’nın doğru çalışıp çalışmadığını, hangi rich result türlerine uygun olduğunu ve varsa hataları gösteriyor. Her schema değişikliğinden sonra çalıştırın.

Schema Markup Validator

validator.schema.org: Schema.org’un resmi doğrulama aracı. Google’ın önerdiği rich results dışındaki schema kullanımları için daha kapsamlı.

Google Search Console

“İyileştirmeler” bölümünde schema türlerine göre gruplandırılmış hata raporları var. Hangi URL’lerde, hangi alanda sorun olduğunu toplu biçimde gösteriyor. Büyük siteler için vazgeçilmez.

Ahrefs ve Semrush Site Audit

Site genelindeki schema kullanımını ve eksikliklerini raporluyor. Hangi sayfalarda schema olmadığını, hangilerinde hata olduğunu toplu tespit etmek için kullanışlı.

Sık yapılan hatalar

Schema ile görünür içeriğin uyuşmaması. Schema’da yazan bilgi sayfada yoksa Google spam olarak değerlendiriyor. Her zaman bire bir eşleştirme yapın.

Birden fazla sayfada aynı schema’yı kopyalamak. Her sayfanın schema’sı o sayfaya özel olmalı. URL, başlık ve içerik alanları dinamik olarak doldurulmalı.

Yanlış schema türü seçimi. Bir blog yazısını Product olarak işaretlemek veya hizmet sayfasını Article olarak tanımlamak hatalı. Her sayfa türü için doğru schema seçimi kritik.

Eksik zorunlu alanlar. Her schema türünün Google’ın rich results için beklediği zorunlu alanları var. Eksikler hem rich result şansını düşürüyor hem de Search Console’da uyarı üretiyor.

Yalnızca öne çıkan sayfalara schema eklemek. Schema, site genelinde uygulandığında en yüksek etkiyi veriyor. Sadece ana sayfaya veya birkaç blog yazısına eklemek fırsatı sınırlıyor.

JSON-LD sözdizimi hataları. Eksik virgül, kapanmayan parantez, çift tırnak yerine tek tırnak kullanımı. Rich Results Test ile her değişiklik sonrası doğrulama bu hataları önlüyor.

CMS ve framework’lerde schema uygulaması

WordPress: Yoast SEO, Rank Math ve Schema Pro eklentileri otomatik schema üretiyor. Yoast ve Rank Math temel türleri (Article, Organization, BreadcrumbList) ücretsiz katmanda sunuyor.

Shopify: Product ve Organization schema büyük ölçüde otomatik geliyor. Özel türler için metafield veya script tag eklenmesi gerekiyor.

Astro (bu site): Schema, layout dosyasına veya ilgili component’a <script type="application/ld+json"> olarak ekleniyor. Dinamik değerleri props ile aktarmak mümkün.

Next.js: next/head içinde JSON-LD script’i ekleniyor. Dinamik sayfalar için getStaticProps veya getServerSideProps ile veri aktarımı yapılıyor.

Headless CMS (Contentful, Sanity): İçerik modelindeki alanları schema’ya dinamik olarak bağlamak gerekiyor. Genellikle layout veya page component seviyesinde merkezi yönetim öneriliyor.

Schema ve GEO: AI motorları için önemi

Google AI Overviews ve Perplexity, FAQPage schema’sı olan sayfaları soru-cevap formatında yanıtlarda doğrudan kullanıyor. Bu, structured data’nın GEO değerini somutlaştırıyor.

Pratik tavsiye: her içeriğe FAQPage schema ekleyin. SSS bölümünüzü hem görünür HTML olarak hem de schema olarak sunun. Bu tek adım hem AEO hem GEO kanallarında görünürlüğü artırıyor. Konunun detayı için SEO, AEO ve GEO rehberimiz iyi bir kaynak.

Öncelik sırası: nereden başlamak gerekiyor?

Sıfırdan başlayan bir site için pratik öncelik:

  1. Organization schema: Site genelinde, ana sayfaya ekleyin. Marka kimliği ve Knowledge Graph için temel.
  2. BreadcrumbList: Tüm iç sayfalarda. Rich results ve navigasyon sinyali.
  3. Article / BlogPosting: Her blog yazısında. E-E-A-T ve yazar sinyali.
  4. FAQPage: SSS bölümü olan her sayfada. Hızlı rich result kazanımı.
  5. WebSite: Ana sayfada. Sitelink arama kutusu için.
  6. LocalBusiness: Yerel hizmet veriyorsanız. Yerel arama görünürlüğü.
  7. HowTo: Adım adım rehber içeriklerinde. Güçlü rich result formatı.
  8. Product / Review: E-ticaret sayfalarında. SERP’te fiyat ve puan görünürlüğü.

Sıkça Sorulan Sorular

Schema markup doğrudan sıralamayı artırır mı?

Doğrudan bir sıralama faktörü değil. Ama rich results kazandırarak CTR’yi artırıyor, AI motorlarında kaynak seçilme olasılığını yükseliyor ve Google’ın içeriği doğru anlamasına katkı sağlıyor. Dolaylı ama güçlü etkisi var.

Bir sayfaya birden fazla schema eklenebilir mi?

Evet. Örneğin bir blog yazısı sayfasına aynı anda BlogPosting, FAQPage ve BreadcrumbList eklenebilir. Her biri ayrı <script> bloğu olarak ya da tek bir blokta dizi formatında yazılabilir.

Schema eklemek için geliştirici gerekmez mi?

Basit schema türleri için WordPress eklentileri (Yoast, Rank Math) teknik bilgi gerektirmeden uygulanabiliyor. Özel ve dinamik schema için temel HTML ve JSON bilgisi yeterli.

FAQPage schema’sı her zaman rich result kazandırır mı?

Hayır, garanti değil. Google, rich results gösterip göstermemeye kullanıcı sorgusuna, rekabetin yoğunluğuna ve sayfanın genel kalitesine göre karar veriyor. Ama doğru schema, şansı belirgin biçimde artırıyor.

Schema’yı güncellemek SEO’ya zarar verir mi?

Hayır, tam tersi. İçerik güncellendiğinde schema’nın da güncellenmesi gerekiyor. dateModified alanını gerçek içerik güncellemesinde güncel tutmak güven sinyali veriyor.

Google Schema.org’un tüm türlerini destekliyor mu?

Hayır. Google’ın desteklediği rich result türleri ve zorunlu alanlar developers.google.com/search/docs/appearance/structured-data adresinde listeleniyor. Schema.org’da olmayan her tür Google tarafından işlenmiyor.

Schema hatası sıralamayı düşürür mü?

Küçük hatalar genellikle uyarı üretiyor; ceza değil. Ama spam amaçlı kullanım (görünür içerikle uyuşmayan schema) manuel cezaya yol açabiliyor. Search Console’daki uyarıları düzenli kontrol edin.

Speakable schema nedir ve kullanmalı mıyım?

Google’ın sesli arama için önerdiği schema türü. Sayfanın sesli okumaya uygun bölümlerini işaretliyor. Henüz sınırlı destek ve beta niteliğinde; News yayıncıları için daha kritik, blog ve hizmet siteleri için öncelikli değil.

Sonuç

Structured data ve schema markup, teknik SEO’nun en doğrudan getirili uygulamalarından biri. Doğru türleri doğru sayfalara eklemek; rich results, AI kaynak seçimi ve sesli yanıt görünürlüğü üzerinde somut etki yaratıyor.

Üç maddede özetlemek gerekirse:

  1. Organization, BreadcrumbList ve Article schema’yı site genelinde uygulayın; temel sinyaller bu üçten geliyor.
  2. Her içeriğe FAQPage schema ekleyin; hem AEO hem GEO için en hızlı kazanım.
  3. Her değişikliği Google Rich Results Test ile doğrulayın; hatasız schema, hatalıdan çok daha değerli.

E-E-A-T sinyalleri ve schema’nın birlikte nasıl çalıştığını görmek için Google E-E-A-T rehberimize geçebilirsiniz. Sitenizin schema yapısını denetlemek ve uygulamak için ücretsiz SEO danışmanlığı teklifi alabilirsiniz.

Profesyonel Destek

Bu konuda profesyonel destek almak ister misiniz?

SEO Danışmanlığı hizmetimizle projenizi bir üst seviyeye taşıyın. Ücretsiz ön değerlendirme ile başlayın.