Google arama sonuçlarında yıldızlı puanlar, SSS listeleri, adım adım tarifler veya etkinlik tarihleri görmüşsünüzdür. Bu zengin görünümler tesadüf değildir; sayfanın arka planında, arama motorlarının anlayabileceği bir dilde yazılmış yapısal verinin ürünüdür. Bu dile Schema.org adı verilir ve bu rehber, o dilin sözlüğüdür.

Schema.org’u ilk kez duyuyorsanız ya da hangi türü nerede kullanacağınız konusunda kafanız karışıksa doğru yerdesiniz. Bu kapsamlı sözlük; 30’dan fazla schema türünü, her birinin zorunlu ve önerilen alanlarını, gerçek JSON-LD örneklerini ve hangi rich result’ı tetiklediğini tek bir referans noktasında sunuyor. Teknik SEO hizmetlerimiz kapsamında müşteri sitelerinde uyguladığımız deneyimleri de bu rehbere yansıttık.

Temel Kavramlar

Schema.org Nedir?

Schema.org, Google, Bing, Yahoo ve Yandex’in 2011 yılında ortaklaşa kurduğu bir kelime dağarcığıdır. Amacı; web sayfalarındaki içeriğin ne anlama geldiğini arama motorlarının daha iyi anlayabilmesi için ortak bir işaretleme standartı oluşturmaktır.

Bir sayfa “Dr. Ahmet Yılmaz, İstanbul’da göğüs cerrahisi hizmeti veriyor” diye yazabilir. İnsan bunu kolayca anlar; ancak arama motoru için bu cümle yalnızca kelimelerden ibarettir. Schema.org ile aynı bilgiyi yapısal biçimde sunduğunuzda makine şunu anlar: Bu kişi bir Physician, uzmanlık alanı ThoracicSurgery, çalıştığı yer MedicalClinic türünde bir kurum ve konum Istanbul, TR. Bu anlayış farkı doğrudan sıralama kalitesini ve görünürlüğü etkiler.

JSON-LD vs Microdata vs RDFa

Schema.org işaretlemesi üç farklı sözdizimi ile yazılabilir:

JSON-LD (JavaScript Object Notation for Linked Data): Google’ın önerdiği ve en yaygın kullanılan yöntemdir. Sayfanın <head> ya da <body> bölümünde <script type="application/ld+json"> etiketleri arasına yazılır. HTML yapısından bağımsız olduğu için eklemesi, güncellenmesi ve taşınması en kolay yöntemdir.

Microdata: HTML etiketlerine itemscope, itemtype ve itemprop öznitelikleri eklenerek kullanılır. HTML ile iç içe geçtiği için bakımı güçtür; ancak bazı eski CMS şablonlarında hâlâ görülür.

RDFa: Özellikle akademik ve hükümet sitelerinde tercih edilen, daha karmaşık bir sözdizimi. Genel web SEO çalışmaları için önerilmez.

Pratik öneri: Her zaman JSON-LD kullanın. Google bu yöntemi açıkça tercih ettiğini belgelemiş durumdadır ve sayfa HTML’ini bozmadan işaretleme ekleyip kaldırmanızı sağlar.

@context ve @type Alanları

Her JSON-LD bloğunun iki zorunlu anahtarı vardır:

@context: Kullanılan kelime dağarcığını belirtir. Hemen her zaman "https://schema.org" değerini alır.
@type: Tanımlanan varlığın türünü belirtir. "Article", "Product", "LocalBusiness" gibi.

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Schema.org Rehberi"
}

Google’ın Desteklediği Şemalar ile Desteklemedikleri

Schema.org’da 800’ü aşkın tür ve özellik tanımlanmıştır; ancak Google bunların tamamını rich result üretmek için kullanmaz. Google’ın zengin sonuç desteklediği başlıca türler şunlardır: Article, BreadcrumbList, Carousel, Course, Dataset, Event, FAQPage, HowTo, ImageObject, JobPosting, LocalBusiness, Movie, Product/Offer, QAPage, Recipe, Review, SiteLinksSearchBox, VideoObject, Speakable.

Bunların dışındaki türler (örneğin MedicalCondition, Drug, Person) rich result tetiklemez; ancak Knowledge Graph ve bilgi paneli için değer taşır, dolayısıyla eklenmesi yine de önerilir.

Rich Results Test Nasıl Kullanılır?

Google’ın Rich Results Test aracına bir URL ya da ham HTML/JSON-LD kod parçası girerek şemanızın geçerli olup olmadığını ve hangi zengin sonuçları tetikleyeceğini anında görebilirsiniz. Hata (error) ile uyarı (warning) arasındaki farkı iyi anlayın: Hata varlığı, rich result’ın tamamen devre dışı kalması anlamına gelir; uyarı ise eksik önerilen alan anlamına gelir ve sonucu tamamen engellemez.

Rich Result Türleri Karşılaştırma Tablosu

Schema Türü	Rich Result	SERP Görünümü
Article / NewsArticle	Top Stories carousel	Büyük resim, başlık, kaynak
Recipe	Recipe rich result	Resim, süre, kalori, puan
FAQPage	FAQ accordion	Soru-cevap genişleyen liste
HowTo	HowTo steps	Numaralı adımlar
Product + Offer + AggregateRating	Product rich result	Fiyat, stok, yıldız
Event	Event rich result	Tarih, saat, konum
LocalBusiness	Local Knowledge Panel	Harita, saat, puan
BreadcrumbList	Breadcrumb URL	URL yerine ekmek kırıntısı
JobPosting	Job rich result	Şirket, maaş, konum
VideoObject	Video rich result	Küçük resim, süre
Course	Course rich result	Kurs adı, sağlayıcı
SiteLinksSearchBox	Arama kutusu	Site içi arama SERP’te
Dataset	Dataset rich result	Veri seti özeti
Speakable	Google Asistan	Sesli okuma
ClaimReview	Fact Check etiketi	Doğruluk etiketi

İçerik Şemaları

Article

Ne işe yarar: Haber, blog yazısı veya makale türündeki içerikleri işaretler. Google bu şemayı Top Stories carousel’de göstermek için kullanır.

Hangi sayfalarda kullanılır: Blog yazıları, haber makaleleri, rehber içerikler.

Zorunlu alanlar: headline, image, datePublished, author

Önerilen alanlar: dateModified, description, publisher, mainEntityOfPage

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Schema.org Türleri Sözlüğü: Yapısal Veri Rehberi",
  "description": "Schema.org yapısal veri türlerinin kapsamlı Türkçe rehberi.",
  "image": "https://ornek.com/images/schema-rehberi.jpg",
  "datePublished": "2026-07-13T09:00:00+03:00",
  "dateModified": "2026-07-13T09:00:00+03:00",
  "author": {
    "@type": "Person",
    "name": "Onur Öztürk",
    "url": "https://ornek.com/hakkimda"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Ornek SEO",
    "logo": {
      "@type": "ImageObject",
      "url": "https://ornek.com/logo.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://ornek.com/blog/schema-rehberi"
  }
}

Dikkat edilecekler: image alanının en az 1200x630 piksel boyutunda olması Top Stories için gereklidir. NewsArticle alt türü haber yayıncıları içindir; genel bloglar için BlogPosting veya üst tür olan Article yeterlidir.

BlogPosting ve NewsArticle

Her ikisi de Article türünün alt sınıfıdır ve aynı alanları destekler. BlogPosting, kişisel ya da kurumsal bloglar için; NewsArticle, baskı medyası ve haber portalları için uygundur. AMP sayfalarının Top Stories’e girmesi için NewsArticle zorunluydu; ancak 2021 sonrasında AMP zorunluluğu kalktı.

Article hiyerarşisinde dikkat edilmesi gereken önemli bir nokta: Google, Article şemasını E-E-A-T sinyali olarak değerlendirmez; onu yalnızca içerik türünü tanımlamak için kullanır. Ancak author alanına bir Person nesnesi bağlamak ve o kişinin sameAs ile sosyal medya/LinkedIn profillerini tanımlamak, Google’ın yazar otoritesini dolaylı olarak değerlendirmesine katkı sağlar. Kısaca: schema, E-E-A-T’yi otomatik olarak sağlamaz; ama kanıtlamanıza yardımcı olacak altyapıyı kurar.

Book

Kitap içeriklerini, kitap inceleme sayfalarını veya kütüphane kataloglarını işaretler. Google, Book şemasını Knowledge Graph’a bağlamak için kullanır; doğrudan bir rich result türü üretmez; ancak marka bilinirliği ve bilgi paneli görünürlüğü açısından değerlidir.

Önerilen alanlar: name, author, isbn, numberOfPages, publisher, datePublished, inLanguage, genre

{
  "@context": "https://schema.org",
  "@type": "Book",
  "name": "SEO'nun Bilimsel Temelleri",
  "author": {
    "@type": "Person",
    "name": "Onur Öztürk"
  },
  "isbn": "978-605-9999-01-2",
  "numberOfPages": 312,
  "publisher": {
    "@type": "Organization",
    "name": "Örnek Yayınevi"
  },
  "datePublished": "2025-03-01",
  "inLanguage": "tr",
  "genre": "Bilgisayar / İnternet"
}

Movie

Film ve belgesel içerikleri için kullanılır. IMDb veya sinema sitelerinde uygulanabilir. Google, Movie şemasını bilgi paneli verileriyle ilişkilendirir.

Önerilen alanlar: name, director, actor, dateCreated, duration, genre, aggregateRating, trailer

{
  "@context": "https://schema.org",
  "@type": "Movie",
  "name": "Bozkır Rüzgarı",
  "director": {
    "@type": "Person",
    "name": "Zeynep Arslan"
  },
  "actor": [
    {"@type": "Person", "name": "Ahmet Demir"},
    {"@type": "Person", "name": "Selin Çelik"}
  ],
  "dateCreated": "2025-11-15",
  "duration": "PT118M",
  "genre": ["Drama", "Tarih"],
  "inLanguage": "tr",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "7.8",
    "ratingCount": "4523"
  }
}

MusicRecording ve MusicAlbum

Müzik platformları, sanatçı siteleri ve müzik eleştiri siteleri için kullanılır. Google, bu türleri Knowledge Graph’a bağlar; örneğin bir şarkıyı aradığınızda sanatçı bilgi panelinde albüm adı ve yayın tarihi görünebilir.

{
  "@context": "https://schema.org",
  "@type": "MusicRecording",
  "name": "Yağmur Altında",
  "byArtist": {
    "@type": "MusicGroup",
    "name": "Örnek Grup"
  },
  "inAlbum": {
    "@type": "MusicAlbum",
    "name": "Dört Mevsim"
  },
  "duration": "PT3M45S",
  "datePublished": "2025-06-01"
}

Podcast

Podcast içerikleri için kullanılır. PodcastSeries tüm diziyi tanımlarken PodcastEpisode bireysel bölümleri işaretler. Google Podcasts bu şemayı podcast’lerin arama sonuçlarında görünmesi için kullanıyordu; uygulama günümüzde farklı platformlarca benimsenmiştir.

{
  "@context": "https://schema.org",
  "@type": "PodcastEpisode",
  "name": "Schema.org ile Zengin Sonuçlar",
  "episodeNumber": 42,
  "partOfSeries": {
    "@type": "PodcastSeries",
    "name": "SEO Günlüğü",
    "url": "https://seogünlügü.com/podcast"
  },
  "datePublished": "2026-07-13",
  "duration": "PT38M",
  "description": "Bu bölümde Schema.org'un temel kavramlarını ve JSON-LD uygulamalarını konuşuyoruz.",
  "associatedMedia": {
    "@type": "MediaObject",
    "contentUrl": "https://seogünlügü.com/podcast/ep42.mp3"
  }
}

Recipe

Ne işe yarar: Tarif içeriklerini işaretler ve en zengin SERP görünümlerinden birini tetikler: resim, pişirme süresi, kalori, malzeme sayısı ve AggregateRating yıldızları.

Zorunlu alanlar: name, image, recipeIngredient, recipeInstructions

Önerilen alanlar: cookTime, prepTime, totalTime, recipeYield, nutrition, aggregateRating

{
  "@context": "https://schema.org",
  "@type": "Recipe",
  "name": "Fırında Tavuk But",
  "image": ["https://ornek.com/images/tavuk-but.jpg"],
  "description": "Baharatlı ve sulu fırında tavuk but tarifi.",
  "author": {
    "@type": "Person",
    "name": "Ayşe Yılmaz"
  },
  "datePublished": "2026-07-13",
  "prepTime": "PT15M",
  "cookTime": "PT45M",
  "totalTime": "PT60M",
  "recipeYield": "4 kişilik",
  "recipeCategory": "Ana Yemek",
  "recipeCuisine": "Türk",
  "recipeIngredient": [
    "4 adet tavuk but",
    "2 yemek kaşığı zeytinyağı",
    "1 tatlı kaşığı tuz",
    "1 tatlı kaşığı kırmızı biber"
  ],
  "recipeInstructions": [
    {
      "@type": "HowToStep",
      "name": "Marineleme",
      "text": "Tavuk butları zeytinyağı ve baharatlarla karıştırın, 30 dakika bekletin."
    },
    {
      "@type": "HowToStep",
      "name": "Pişirme",
      "text": "180°C'ye ısıtılmış fırında 45 dakika pişirin."
    }
  ],
  "nutrition": {
    "@type": "NutritionInformation",
    "calories": "320 kalori"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "ratingCount": "127"
  }
}

VideoObject

Ne işe yarar: Video içeriklerini işaretler. YouTube’a yüklenen videolar Google tarafından otomatik olarak algılanır; ancak kendi sunucunuzdaki ya da sitenize gömdüğünüz videolar için bu şema gereklidir.

Zorunlu alanlar: name, description, thumbnailUrl, uploadDate

Önerilen alanlar: duration, contentUrl, embedUrl, expires

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Schema.org JSON-LD Nasıl Eklenir?",
  "description": "Adım adım JSON-LD yapısal veri ekleme rehberi.",
  "thumbnailUrl": "https://ornek.com/images/video-thumb.jpg",
  "uploadDate": "2026-07-13T10:00:00+03:00",
  "duration": "PT12M30S",
  "contentUrl": "https://ornek.com/videos/jsonld-rehberi.mp4",
  "embedUrl": "https://www.youtube.com/embed/abc123"
}

Course

Ne işe yarar: Çevrimiçi veya yüz yüze kursları işaretler. Google, kurs adını, sağlayıcıyı ve açıklamayı SERP’te gösterebilir.

Zorunlu alanlar: name, description, provider

Önerilen alanlar: hasCourseInstance, url, aggregateRating

{
  "@context": "https://schema.org",
  "@type": "Course",
  "name": "İleri Düzey SEO Eğitimi",
  "description": "Teknik SEO, içerik stratejisi ve link inşası konularını kapsayan 8 haftalık online eğitim.",
  "provider": {
    "@type": "Organization",
    "name": "Ornek Akademi",
    "sameAs": "https://ornekakademi.com"
  },
  "hasCourseInstance": {
    "@type": "CourseInstance",
    "courseMode": "online",
    "startDate": "2026-08-01",
    "endDate": "2026-09-26",
    "courseWorkload": "PT5H"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.9",
    "ratingCount": "214"
  }
}

İşletme & Yerel SEO Şemaları

LocalBusiness

Yerel işletmeler için en kritik şema türüdür. Doğru uygulandığında Google Maps sonuçlarında, yerel paket (local pack) listesinde ve bilgi panelinde görünürlüğü artırır.

Zorunlu alanlar: name, address

Önerilen alanlar: telephone, openingHoursSpecification, geo, url, image, aggregateRating, priceRange

Alt türler ve kullanım alanları:

Alt Tür	Kullanım Alanı
Restaurant	Kafe, restoran, yemek işletmeleri
MedicalClinic	Özel klinik, sağlık merkezi
Dentist	Diş kliniği
Hospital	Hastane
LegalService	Avukatlık bürosu
AccountingService	Muhasebe bürosu
HairSalon	Kuaför, güzellik salonu
AutoRepair	Oto servis
Gym	Spor salonu

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Örnek Güzellik Salonu",
  "image": "https://orneksalon.com/images/salon.jpg",
  "url": "https://orneksalon.com",
  "telephone": "+90-212-555-0001",
  "priceRange": "₺₺",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Bağcılar Cad. No:15",
    "addressLocality": "Bağcılar",
    "addressRegion": "Istanbul",
    "postalCode": "34200",
    "addressCountry": "TR"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 41.0389,
    "longitude": 28.8562
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday"],
      "opens": "09:00",
      "closes": "19:00"
    },
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": "Saturday",
      "opens": "10:00",
      "closes": "17:00"
    }
  ],
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "ratingCount": "89"
  }
}

Restaurant

LocalBusiness alt türüdür; restoran, kafe, fast-food zincirleri için kullanılır. servesCuisine, hasMenu, acceptsReservations gibi özel alanlar içerir.

{
  "@context": "https://schema.org",
  "@type": "Restaurant",
  "name": "Lezzet Durağı",
  "servesCuisine": ["Türk Mutfağı", "Kebap"],
  "hasMenu": "https://lezzetduragi.com/menu",
  "acceptsReservations": "https://lezzetduragi.com/rezervasyon",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Kapalıçarşı Cad. No:8",
    "addressLocality": "Fatih",
    "addressCountry": "TR"
  },
  "telephone": "+90-212-555-0202"
}

Organization, Corporation ve NGO

Organization, bir kurumu genel olarak tanımlar. Alt türleri:

Corporation: Ticari şirketler için
NGO: Sivil toplum kuruluşları için
EducationalOrganization: Okul, üniversite, eğitim kurumları için
GovernmentOrganization: Devlet kurumları için

sameAs özelliği, kurumun Google Bilgi Grafiği (Knowledge Graph) ile eşleştirilmesini sağlar. LinkedIn, Wikipedia, Wikidata ve sosyal medya profillerini buraya ekleyin.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Ornek Teknoloji A.Ş.",
  "url": "https://ornekteknoloji.com",
  "logo": "https://ornekteknoloji.com/logo.png",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+90-212-555-0300",
    "contactType": "customer service",
    "availableLanguage": ["Turkish","English"]
  },
  "sameAs": [
    "https://www.linkedin.com/company/ornekteknoloji",
    "https://twitter.com/ornekteknoloji",
    "https://www.facebook.com/ornekteknoloji"
  ]
}

Ürün & E-Ticaret Şemaları

Product, Offer ve AggregateRating

E-ticaret sayfaları için en önemli şema kombinasyonu budur. Google, Product + Offer + AggregateRating üçlüsüyle oluşturulmuş işaretlemeyi SERP’te fiyat, stok durumu ve yıldız puanıyla birlikte gösterir.

Product zorunlu alanlar: name

Product önerilen alanlar: image, description, brand, sku, offers, aggregateRating, review

Offer zorunlu alanlar: price, priceCurrency, availability

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Kablosuz Kulaklık Pro X200",
  "image": [
    "https://ornekmagaza.com/images/kulaklik-1.jpg",
    "https://ornekmagaza.com/images/kulaklik-2.jpg"
  ],
  "description": "40 saat pil ömürlü, aktif gürültü giderme özellikli kablosuz kulaklık.",
  "brand": {
    "@type": "Brand",
    "name": "AudioTech"
  },
  "sku": "AT-X200-BLK",
  "gtin13": "1234567890128",
  "offers": {
    "@type": "Offer",
    "url": "https://ornekmagaza.com/kulaklik-pro-x200",
    "priceCurrency": "TRY",
    "price": "1899.00",
    "priceValidUntil": "2026-12-31",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition",
    "seller": {
      "@type": "Organization",
      "name": "Örnek Mağaza"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "bestRating": "5",
    "worstRating": "1",
    "ratingCount": "342"
  },
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "5"
    },
    "author": {
      "@type": "Person",
      "name": "Mehmet K."
    },
    "reviewBody": "Ses kalitesi mükemmel, pil ömrü reklamda söylendiği gibi."
  }
}

AggregateOffer

Aynı ürünü birden fazla satıcının sattığı karşılaştırma sayfaları veya marketplace’ler için kullanılır.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Laptop Model Z500",
  "offers": {
    "@type": "AggregateOffer",
    "lowPrice": "24999",
    "highPrice": "27500",
    "priceCurrency": "TRY",
    "offerCount": "5"
  }
}

ItemList

Listeler (en iyi 10 ürün, kategori listeleri) için kullanılır. Carousel rich result ile ilişkilidir; ancak Google bu özelliği henüz sınırlı sayıda sektörde göstermektedir.

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "name": "En İyi 5 Bluetooth Kulaklık",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "url": "https://ornekmagaza.com/kulaklik-a"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "url": "https://ornekmagaza.com/kulaklik-b"
    }
  ]
}

Soru-Cevap & Bilgi Şemaları

FAQPage

SERP’te en çok dikkat çeken rich result türlerinden biridir. SSS bölümü içeren her türlü sayfada kullanılabilir. Google, soruları doğrudan arama sonucunda açılıp kapanabilir liste olarak gösterir.

Zorunlu alanlar: mainEntity dizisi içinde Question ve Answer nesneleri

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Schema.org neden önemlidir?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Schema.org, arama motorlarının sayfanızdaki içeriği daha iyi anlamasını sağlar ve zengin sonuçlar (rich results) ile tıklama oranınızı artırabilir."
      }
    },
    {
      "@type": "Question",
      "name": "JSON-LD hangi etiketin içine eklenir?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "JSON-LD, sayfanın &lt;head&gt; veya &lt;body&gt; bölümünde &lt;script type='application/ld+json'&gt; etiketleri arasına eklenir."
      }
    },
    {
      "@type": "Question",
      "name": "FAQPage şeması her sayfada kullanılabilir mi?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Hayır. Google yalnızca gerçekten kullanıcıların sıkça sorduğu soruların yer aldığı sayfalarda bu şemayı destekler; şişirilmiş veya gereksiz SSS bölümleri spam olarak değerlendirilebilir."
      }
    }
  ]
}

Dikkat edilecekler: Google, 2023 sonrasında FAQPage için gösterim sınırlarını daraltmıştır. Yalnızca sitenin yetkili ve güvenilir olduğunu kanıtlamış alanlarda zengin sonuç çıkabilir. Her sorunun cevabı 1500 karakteri geçmemeli ve dürüst bilgi içermelidir.

HowTo

Adım adım yapılacak işlemler için kullanılır. SERP’te numaralı adımlar, adım görselleri ve video bölümleri olarak gösterilebilir.

Zorunlu alanlar: name, step (HowToStep dizisi)

Önerilen alanlar: totalTime, supply, tool, estimatedCost, image

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Web Sitenize JSON-LD Schema Nasıl Eklenir?",
  "description": "JSON-LD yapısal veriyi herhangi bir web sitesine eklemenin adım adım yolu.",
  "totalTime": "PT20M",
  "step": [
    {
      "@type": "HowToStep",
      "position": 1,
      "name": "Schema türünü belirleyin",
      "text": "Sayfanızın içeriğine en uygun Schema.org türünü seçin: Article, Product, FAQPage vb.",
      "image": "https://ornek.com/images/adim1.jpg"
    },
    {
      "@type": "HowToStep",
      "position": 2,
      "name": "JSON-LD kodunu oluşturun",
      "text": "Schema.org belgelerini referans alarak gerekli alanları doldurun."
    },
    {
      "@type": "HowToStep",
      "position": 3,
      "name": "Kodu sayfaya ekleyin",
      "text": "Oluşturduğunuz JSON-LD kodunu &lt;script type='application/ld+json'&gt; etiketi içinde sayfanıza ekleyin."
    },
    {
      "@type": "HowToStep",
      "position": 4,
      "name": "Rich Results Test ile doğrulayın",
      "text": "Google'ın Rich Results Test aracına sayfanızın URL'sini girerek şemanın geçerli olup olmadığını kontrol edin."
    }
  ]
}

DefinedTerm ve DefinedTermSet

Terim sözlükleri ve ansiklopedik içerikler için kullanılır. Google Bilgi Grafiği ile eşleşmeyi kolaylaştırır; ancak şu an için zengin sonuç üretmez.

{
  "@context": "https://schema.org",
  "@type": "DefinedTermSet",
  "name": "SEO Sözlüğü",
  "hasDefinedTerm": [
    {
      "@type": "DefinedTerm",
      "name": "Backlink",
      "description": "Başka bir web sitesinden sizin sitenize verilen bağlantı.",
      "inDefinedTermSet": "https://ornek.com/seo-sozlugu"
    }
  ]
}

Navigasyon & Site Yapısı

BreadcrumbList

Sayfanın site hiyerarşisindeki konumunu gösterir. SERP’te URL yerine /Blog / Teknik SEO / Schema Rehberi biçiminde görünür; bu kullanıcıların tıklama kararını olumlu etkiler.

Zorunlu alanlar: Her ListItem için position, item (veya name)

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Ana Sayfa",
      "item": "https://ornek.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog",
      "item": "https://ornek.com/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Teknik SEO",
      "item": "https://ornek.com/blog/teknik-seo"
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "Schema.org Türleri Sözlüğü"
    }
  ]
}

SiteLinksSearchBox

Ana sayfanıza eklenen bu şema, Google’ın SERP’te marka adınızla arama yapıldığında site içi arama kutusu göstermesini mümkün kılar. Her sitenin buna uygun sayılmayacağını unutmayın; Google kendi algoritmasına göre karar verir.

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "url": "https://ornek.com",
  "potentialAction": {
    "@type": "SearchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://ornek.com/ara?q={search_term_string}"
    },
    "query-input": "required name=search_term_string"
  }
}

WebSite ve WebPage

WebSite ana sayfa için kullanılırken WebPage bireysel sayfaları tanımlamak için idealdir. WebPage alt türleri arasında ContactPage, AboutPage, CheckoutPage, CollectionPage yer alır.

{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "Schema.org Türleri Sözlüğü",
  "description": "30+ schema türünün Türkçe açıklaması ve JSON-LD örnekleri.",
  "url": "https://ornek.com/blog/schema-turleri-sozlugu",
  "breadcrumb": {
    "@type": "BreadcrumbList",
    "itemListElement": [
      {"@type": "ListItem", "position": 1, "name": "Ana Sayfa", "item": "https://ornek.com"},
      {"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://ornek.com/blog"}
    ]
  }
}

Etkinlik & Takvim

Event

Konserler, konferanslar, spor etkinlikleri, webinarlar ve her türlü etkinlik için kullanılır. Hem fiziksel hem de çevrimiçi etkinlikler desteklenir.

Zorunlu alanlar: name, startDate, location

Önerilen alanlar: endDate, eventStatus, eventAttendanceMode, offers, organizer, image

{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "İstanbul SEO Zirvesi 2026",
  "startDate": "2026-09-15T09:00:00+03:00",
  "endDate": "2026-09-15T18:00:00+03:00",
  "eventStatus": "https://schema.org/EventScheduled",
  "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
  "location": {
    "@type": "Place",
    "name": "İstanbul Kongre Merkezi",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "Darülaceze Cad. No:2",
      "addressLocality": "Şişli",
      "addressRegion": "Istanbul",
      "addressCountry": "TR"
    }
  },
  "image": "https://iseo2026.com/images/banner.jpg",
  "description": "Türkiye'nin en büyük SEO etkinliği. 50+ konuşmacı, 1000+ katılımcı.",
  "offers": {
    "@type": "Offer",
    "url": "https://iseo2026.com/bilet",
    "price": "1500",
    "priceCurrency": "TRY",
    "availability": "https://schema.org/InStock",
    "validFrom": "2026-07-01T00:00:00+03:00"
  },
  "organizer": {
    "@type": "Organization",
    "name": "Dijital Pazarlama Derneği",
    "url": "https://dpd.org.tr"
  }
}

Çevrimiçi etkinlik için: eventAttendanceMode değerini "https://schema.org/OnlineEventAttendanceMode" olarak değiştirin ve location yerine "https://schema.org/VirtualLocation" ile URL ekleyin.

İptal ya da erteleme durumunda: eventStatus değerini "https://schema.org/EventCancelled" veya "https://schema.org/EventPostponed" olarak güncelleyin. Bu bilgi SERP’te “İptal Edildi” etiketi olarak görünür.

EventSeries

Düzenli aralıklarla tekrar eden etkinlikler için kullanılır. Bireysel Event nesneleri superEvent özelliğiyle bu seriye bağlanır.

Sağlık & Medikal Şemalar

Sağlık şemaları, Google’ın en titiz davrandığı kategoridir. YMYL (Your Money Your Life) kapsamındaki bu içeriklerde şema yanlışlığı, otorite kaybına yol açabilir. Sağlık turizmi SEO hizmetlerimiz çerçevesinde aşağıdaki şema türlerini aktif olarak kullanıyoruz.

MedicalOrganization ve Physician

{
  "@context": "https://schema.org",
  "@type": "MedicalOrganization",
  "name": "Örnek Sağlık Kliniği",
  "url": "https://ornekkilnik.com",
  "telephone": "+90-212-555-0400",
  "medicalSpecialty": "https://schema.org/Plastic",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nişantaşı Mah. Teşvikiye Cad. No:10",
    "addressLocality": "Şişli",
    "addressRegion": "Istanbul",
    "addressCountry": "TR"
  },
  "openingHoursSpecification": {
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday"],
    "opens": "08:30",
    "closes": "18:00"
  }
}

Physician (Doktor) şeması:

{
  "@context": "https://schema.org",
  "@type": "Physician",
  "name": "Dr. Fatma Kaya",
  "medicalSpecialty": "https://schema.org/Dermatology",
  "worksFor": {
    "@type": "MedicalOrganization",
    "name": "Örnek Dermatoloji Kliniği"
  },
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "Kadıköy",
    "addressCountry": "TR"
  },
  "telephone": "+90-216-555-0500",
  "url": "https://ornekderma.com/dr-fatma-kaya"
}

MedicalCondition

Hastalık veya sağlık durumunu tanımlar. Zengin sonuç üretmez; ancak Knowledge Graph’a katkı sağlar.

{
  "@context": "https://schema.org",
  "@type": "MedicalCondition",
  "name": "Saç Dökülmesi (Androgenetik Alopesi)",
  "alternateName": "Erkek Tipi Kellik",
  "description": "Saç foliküllerinin hormonlara duyarlılığından kaynaklanan kalıtsal saç dökülmesi.",
  "possibleTreatment": {
    "@type": "MedicalTherapy",
    "name": "Saç Ekimi (FUE)"
  }
}

MedicalProcedure

Operasyonlar ve tedavi yöntemleri için kullanılır. Sağlık turizmi sitelerinde prosedür sayfaları bu şema ile işaretlendiğinde Google, prosedürü daha net anlayabilir.

{
  "@context": "https://schema.org",
  "@type": "MedicalProcedure",
  "name": "FUE Saç Ekimi",
  "procedureType": "https://schema.org/SurgicalProcedure",
  "description": "Foliküler ünite ekstraksiyonu yöntemiyle gerçekleştirilen saç ekimi operasyonu.",
  "bodyLocation": "Kafa derisinin alıcı bölgesi",
  "preparation": "İşlemden 24 saat önce alkol ve kan sulandırıcı ilaçlardan kaçınılmalıdır.",
  "followup": "İşlem sonrası 10-14 gün saç yıkama protokolüne uyulmalıdır."
}

HealthTopicContent

Google’ın Sağlık bilgi panellerinde kullanabileceği türdür. isPartOf ile ilgili WebPage’e bağlanır.

Sağlık turizmi notu: Yabancı hastalara yönelik İngilizce içeriklerde MedicalOrganization + Physician + MedicalProcedure + FAQPage kombinasyonu, Google’ın sayfayı anlamasını ve yetkili bulmasını kolaylaştıran en güçlü schema stratejisidir. Bu kombinasyonun detaylı uygulamasını sağlık turizmi SEO sayfamızda bulabilirsiniz.

Yazarlık & Kişiler

Person ve Author Markup

Blog yazıları, araştırma makaleleri ve uzmanlık içerikleri için yazarın kimliğini netleştirmek E-E-A-T (Deneyim, Uzmanlık, Otorite, Güvenilirlik) açısından kritik önem taşır.

{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "Onur Öztürk",
  "url": "https://ornek.com/hakkimda",
  "jobTitle": "SEO Uzmanı",
  "worksFor": {
    "@type": "Organization",
    "name": "Ornek Dijital"
  },
  "knowsAbout": ["SEO", "Teknik SEO", "İçerik Pazarlaması"],
  "sameAs": [
    "https://www.linkedin.com/in/onurozturk",
    "https://twitter.com/onurozturk",
    "https://www.instagram.com/onurozturk"
  ]
}

ProfilePage: Yazar profil sayfaları için WebPage yerine ProfilePage kullanın:

{
  "@context": "https://schema.org",
  "@type": "ProfilePage",
  "mainEntity": {
    "@type": "Person",
    "name": "Onur Öztürk",
    "description": "10+ yıl deneyimli SEO danışmanı."
  }
}

sameAs ile Bilgi Grafiği Bağlantısı

sameAs özelliği, bir varlığın (kişi, kurum, mekân) birden fazla platformdaki varlığını birbirine bağlar. Google bu bağlantıları kullanarak Knowledge Graph kaydı oluşturur ya da mevcut kaydı güçlendirir. Wikipedia, Wikidata, LinkedIn, Twitter/X, Facebook sayfaları ve resmi web sitesi URL’leri sameAs dizisine dahil edilmelidir.

Yazılım & Teknoloji

SoftwareApplication ve MobileApplication

Uygulama sayfaları, oyunlar veya SaaS araçları için kullanılır.

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "SEO Analiz Aracı Pro",
  "operatingSystem": "Web",
  "applicationCategory": "BusinessApplication",
  "offers": {
    "@type": "Offer",
    "price": "299",
    "priceCurrency": "TRY"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "78"
  }
}

MobileApplication için @type değerini "MobileApplication" olarak değiştirin ve "applicationCategory": "GameApplication" gibi mobil uygulama kategorilerini kullanın.

Eğitim

LearningResource

Eğitici içerikler, ders notları, öğretici makaleler için kullanılır. Course ile karıştırılmamalıdır; LearningResource, tek bir makale veya video gibi bağımsız eğitim içeriklerini tanımlar.

{
  "@context": "https://schema.org",
  "@type": "LearningResource",
  "name": "JSON-LD Temelleri",
  "description": "Sıfırdan JSON-LD öğrenmek isteyenler için interaktif rehber.",
  "educationalLevel": "Beginner",
  "teaches": "Yapısal veri işaretlemesi",
  "timeRequired": "PT30M",
  "inLanguage": "tr"
}

Özel & Gelişmiş Şemalar

JobPosting

İş ilanları için kullanılır. SERP’te Google Jobs kutucuğunda görünür; bu, özellikle işe alım platformları ve şirket kariyer sayfaları için büyük bir trafik kaynağı olabilir.

Zorunlu alanlar: title, description, datePosted, hiringOrganization, jobLocation veya applicantLocationRequirements (uzaktan iş ise)

{
  "@context": "https://schema.org",
  "@type": "JobPosting",
  "title": "Senior SEO Uzmanı",
  "description": "Dijital büyüme ajansımız için deneyimli SEO uzmanı arıyoruz.",
  "datePosted": "2026-07-13",
  "validThrough": "2026-08-13T23:59",
  "employmentType": "FULL_TIME",
  "hiringOrganization": {
    "@type": "Organization",
    "name": "Ornek Dijital",
    "sameAs": "https://ornekdijital.com",
    "logo": "https://ornekdijital.com/logo.png"
  },
  "jobLocation": {
    "@type": "Place",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "Levent Mah.",
      "addressLocality": "Beşiktaş",
      "addressRegion": "Istanbul",
      "addressCountry": "TR"
    }
  },
  "baseSalary": {
    "@type": "MonetaryAmount",
    "currency": "TRY",
    "value": {
      "@type": "QuantitativeValue",
      "minValue": 60000,
      "maxValue": 90000,
      "unitText": "MONTH"
    }
  }
}

Dataset

Araştırma verileri, istatistik dosyaları, açık veri kaynakları için kullanılır. Google Dataset Search’te görünürlük sağlar.

{
  "@context": "https://schema.org",
  "@type": "Dataset",
  "name": "Türkiye Organik Trafik Analizi 2026",
  "description": "Türkiye'deki 500 web sitesinin 2025-2026 organik trafik değişim verisi.",
  "url": "https://ornek.com/veriler/trafik-analizi-2026",
  "creator": {
    "@type": "Organization",
    "name": "Ornek Araştırma"
  },
  "datePublished": "2026-07-01",
  "license": "https://creativecommons.org/licenses/by/4.0/"
}

Speakable

Google Asistan ve sesli arama için optimize edilmiş içerik bölümlerini işaret eder. Haber içeriklerinde uygulanabilir; yalnızca Google ile iş ortaklığı olan haber yayıncıları için şu an aktif olarak desteklenmektedir.

{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "Güncel SEO Haberleri",
  "speakable": {
    "@type": "SpeakableSpecification",
    "cssSelector": [".article-headline", ".article-summary"]
  }
}

ClaimReview ve FactCheck

Yanıltıcı bilgileri doğrulayan veya çürüten gazeteciler ve fact-check kuruluşları için tasarlanmıştır. SERP’te “Fact Check” etiketi görünür.

{
  "@context": "https://schema.org",
  "@type": "ClaimReview",
  "url": "https://ornekfactcheck.com/iddia/seo-oldu-mu",
  "claimReviewed": "SEO artık ölmüştür ve hiçbir değeri kalmamıştır.",
  "itemReviewed": {
    "@type": "Claim",
    "author": {
      "@type": "Person",
      "name": "Anonim Sosyal Medya Kullanıcısı"
    }
  },
  "author": {
    "@type": "Organization",
    "name": "Ornek Fact Check"
  },
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": "1",
    "bestRating": "5",
    "worstRating": "1",
    "alternateName": "Yanlış"
  }
}

Doğrulama & Test

Rich Results Test

Google’ın resmi doğrulama aracına URL veya ham kod girebilirsiniz:

URL test: Yayınlanmış sayfanızın şu anda desteklediği rich result türlerini görürsünüz.
Kod test: Henüz yayınlanmamış bir JSON-LD bloğunu doğrudan yapıştırarak hataları önceden yakalayabilirsiniz.
Hata (Error): Rich result tamamen engellenir. Zorunlu bir alan eksik ya da değer formatı yanlış.
Uyarı (Warning): Önerilen alan eksik. Rich result yine de çıkabilir; ancak daha az bilgi gösterilir.

Schema Markup Validator

validator.schema.org adresi, Google’ın araçlarından farklı olarak Schema.org’un kendi spesifikasyonuna göre doğrulama yapar. Google’ın rich result kurallarıyla birebir örtüşmez; ancak syntax hataları ve yanlış kullanılan alanları bulmak için idealdir.

Google Search Console Zengin Sonuçlar Raporu

GSC’nin sol menüsündeki Geliştirmeler bölümünde her schema türü için ayrı bir rapor bulunur. Bu raporlar şunu gösterir:

Kaç URL o şemayı içeriyor
Kaç URL’de hata var
Kaç URL geçerli ama uyarı içeriyor
Geçerli URL’lerin gösterim ve tıklama sayıları

Buraya düzenli olarak bakın; özellikle site güncellemeleri sonrasında hatalar burada belirir.

Yaygın Schema Hataları ve Çözümleri

1. Eksik zorunlu alan

En sık görülen hata. Product şemasına name eklemeden gönderilmesi veya Event şemasında startDate’in unutulması gibi. Çözüm: Her schema türünün Google dokümantasyonunu okuyun ve zorunlu alanları kontrol listesiyle doğrulayın.

2. Geçersiz tarih formatı

Schema.org tarihleri ISO 8601 formatında olmalıdır: 2026-07-13T09:00:00+03:00. 13/07/2026 ya da 13 Temmuz 2026 gibi formatlar geçersizdir.

3. Fiyat değerinin string olması gerekirken sayı girilmesi

"price": 1899 yerine "price": "1899" kullanın. JSON-LD’de bazı alanlar string, bazıları sayı bekler; Schema.org dokümantasyonu bunu belirtir.

4. Sayfadaki içerikle uyumsuz şema

Google’ın açıkça yasakladığı bir uygulama: Sayfada hiç tarif yokken Recipe şeması eklemek ya da gerçek SSS olmayan içeriklere FAQPage koymak. Bu, manuel işlem (manual action) riskini doğurur.

5. Birden fazla şema türünü yanlış iç içe geçirmek

@graph dizisini kullanarak birden fazla şemayı tek JSON-LD bloğu içinde doğru şekilde belirtebilirsiniz:

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "WebPage",
      "@id": "https://ornek.com/blog/schema-rehberi",
      "name": "Schema.org Rehberi"
    },
    {
      "@type": "Article",
      "@id": "https://ornek.com/blog/schema-rehberi#article",
      "headline": "Schema.org Türleri Sözlüğü",
      "isPartOf": {"@id": "https://ornek.com/blog/schema-rehberi"}
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {"@type": "ListItem", "position": 1, "name": "Ana Sayfa", "item": "https://ornek.com"},
        {"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://ornek.com/blog"}
      ]
    }
  ]
}

6. aggregateRating için yetersiz yorum sayısı

Google, az sayıda puanla üretilen yıldız gösterimlerini göstermeyebilir. Genel eşik 5-10 yorum olarak gözlemlenmektedir; ancak resmi bir minimum yayınlanmış değildir.

7. Kendinize yazdığınız yorumlar

Birinci şahıs (“biz ürünümüzü seviyoruz”) ya da çalışanlar tarafından yazılan yorumlar Review şemasında kullanılamaz. Google yönergelerine göre yalnızca gerçek kullanıcı yorumları işaretlenebilir.

Şema Stratejisi: Sayfaya Göre Doğru Kombinasyon

Her sayfa türü için önerilen şema kombinasyonları:

Blog yazısı / Makale: Article + BreadcrumbList + WebPage + FAQPage (varsa SSS bölümü)

Ürün sayfası: Product + Offer + AggregateRating + Review + BreadcrumbList

Yerel işletme ana sayfası: LocalBusiness (veya alt türü) + Organization + WebSite (SiteLinksSearchBox dahil)

Sağlık kliniği sayfası: MedicalOrganization + Physician (doktor profilleri için) + MedicalProcedure + FAQPage + LocalBusiness

Etkinlik sayfası: Event + BreadcrumbList + Organization (düzenleyici)

Kariyer sayfası / İş ilanı: JobPosting + Organization

Tarif sayfası: Recipe + BreadcrumbList + Person (yazar)

Bu kombinasyonlarda dikkat edilmesi gereken nokta şudur: İki şema türü aynı sayfada anlam bakımından çelişmemeli, sayfadaki gerçek içerikle örtüşmeli ve her blok kendi içinde eksiksiz olmalıdır.

Schema.org ve Yapay Zeka Aramaları

2023 sonrasında Bing Copilot, Google SGE/AI Overviews ve benzeri yapay zeka destekli arama özellikleri, Schema.org işaretlemesini daha önce olduğundan daha fazla değerli kılmıştır. Yapay zeka arama motorları, içerik özetleri oluştururken yapısal veriyi düz metinden çok daha verimli biçimde tüketir.

Speakable şeması ve description alanlarının zenginliği, yapay zeka snippet’larında alıntılanma (citation) olasılığını artırır. Benzer biçimde FAQPage içindeki soru-cevap çiftleri, AI Overview kutularına doğrudan çekilmektedir. Bu, FAQPage’in klasik rich result görünümlerinin azaldığı dönemde de değerini korumasının temel nedenidir.

Pratik öneri: Her önemli sayfanın description alanını 150-250 kelime arasında tutun, FAQPage sorularını gerçek kullanıcı sorgularına dayandırın ve Article şemasında about + mentions alanlarını kullanarak sayfanın odak konusunu makineye açıklayın.

ImageObject Şeması

Birçok geliştirici görselleri yalnızca img etiketi olarak ekler ve schema’ya dahil etmeyi unutur. Oysa ImageObject şeması, Google’ın görsel aramada sayfanızı kaynaklandırmasını kolaylaştırır ve Article, Product, Recipe gibi üst şemalarda görsel boyut bilgisini iletmenizi sağlar.

{
  "@context": "https://schema.org",
  "@type": "ImageObject",
  "url": "https://ornek.com/images/schema-infografik.jpg",
  "contentUrl": "https://ornek.com/images/schema-infografik.jpg",
  "width": 1200,
  "height": 630,
  "name": "Schema.org Türleri İnfografik",
  "description": "30 schema türünün özet görsel rehberi.",
  "author": {
    "@type": "Person",
    "name": "Onur Öztürk"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/"
}

ImageObject, Article şemasında image alanı olarak bağlanırken tek bir URL string yerine bu nesneyi kullanırsanız Google daha fazla bağlam bilgisine sahip olur.

Teknik Uygulama: CMS’e Göre JSON-LD Ekleme

WordPress

WordPress’te JSON-LD eklemenin en güvenilir yolu, Yoast SEO veya Rank Math gibi eklentilerin otomatik şema üretme özelliklerini kullanmak ya da temanın functions.php dosyasına wp_head kancasıyla JSON-LD bloğu eklemektir. İkinci yöntemde dinamik PHP değişkenleri (post başlığı, yayın tarihi) otomatik olarak doldurulabilir.

Astro

Bu site gibi Astro tabanlı projelerde JSON-LD, sayfa head bölümünde <script type="application/ld+json"> etiketi ile eklenir. Layout bileşenine prop olarak schema nesnesi geçirilerek her sayfa türüne özel şema üretilebilir:

---
const schema = {
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": frontmatter.title,
  "datePublished": frontmatter.pubDate
};
---
<script type="application/ld+json" set:html={JSON.stringify(schema)} />

Next.js

next/head bileşeni içinde ya da App Router’da generateMetadata fonksiyonuna ek olarak script etiketi ile eklenir.

Schema Öncelik Matrisi: Nereden Başlamalı?

Sitenizde hiç schema yoksa tüm türleri aynı anda eklemeye çalışmak hem zaman kaybı hem de hata riskidir. Aşağıdaki öncelik sırası, çoğu site için geçerli bir başlangıç yol haritası sunar:

1. Aşama — Temel altyapı (tüm siteler için):

Ana sayfa: WebSite + Organization (veya LocalBusiness)
Her sayfa: BreadcrumbList
Blog sayfaları: Article + Person (yazar)

2. Aşama — Sektöre göre öncelikli şemalar:

E-ticaret: Product + Offer + AggregateRating
Hizmet sektörü / yerel işletme: LocalBusiness alt türleri
Sağlık: MedicalOrganization + Physician + MedicalProcedure
Eğitim: Course + EducationalOrganization
Yemek / tarif sitesi: Recipe

3. Aşama — İçerik zenginleştirme:

Sık sorulan sorular bölümü olan her sayfa: FAQPage
Adım adım rehberler: HowTo
Etkinlik sayfaları: Event
İş ilanları: JobPosting

4. Aşama — Gelişmiş uygulama:

@graph ile şemaları birbirine bağlamak
sameAs ile Knowledge Graph eşleştirmesi
speakable ile sesli arama optimizasyonu

Bu aşamalı yaklaşım sayesinde önce en yüksek ROI’li şemaları devreye alır, hata riskini en aza indirirsiniz.

LocalBusiness İçin Özel Dikkat Noktaları

Yerel SEO kapsamında LocalBusiness şeması en kritik yapısal veri türüdür. Doğru uygulanmadığında hem rich result kaybedersiniz hem de Google Haritalar’da yanlış bilgi yayılabilir.

NAP tutarlılığı: Şemadaki name, address ve telephone bilgileri Google Business Profile’daki ve site genelindeki diğer referanslarla birebir aynı olmalıdır. “Cad.” ile “Cadde” arasındaki fark bile tutarsızlık sayılabilir.

Çoklu lokasyon: Birden fazla şubeniz varsa her şube için ayrı bir LocalBusiness nesnesi oluşturun. Bunları @graph dizisine ekleyebilir ya da her şubenin kendi sayfasına koyabilirsiniz. Tüm şubelerin bilgilerini tek bir JSON-LD bloğunda birbirine karıştırmayın.

hasMap alanı: "hasMap": "https://maps.google.com/?cid=XXXXXXXX" şeklinde Google Maps doğrudan bağlantısı eklemek, yerel algoritmadaki güven sinyalini güçlendirir.

Geçici kapanma: İşletmeniz tatilde ya da geçici kapanışta ise specialOpeningHoursSpecification ile belirli tarihlerde farklı saatleri tanımlayabilirsiniz. Bu, kullanıcının yanlış zamanda kapıya gelmesini ve olumsuz yorum bırakmasını önler.

Product Şeması: E-Ticaret Sitelerinin Sık Yaptığı Hatalar

Büyük ölçekli e-ticaret sitelerinde Product şeması uygulamasında tekrarlayan hatalar görülür:

Fiyat güncelliği: priceValidUntil alanı geçmişte kalmış bir tarihe işaret ediyorsa Google, bu ürünün fiyat bilgisini geçersiz kabul edebilir ve rich result kaldırabilir. Dinamik sayfalar için bu alanı otomatik olarak güncelleyen bir mekanizma kurulmalıdır.

Varyantlar için tekil şema: Mavi, kırmızı ve sarı varyantların hepsini tek bir Product nesnesinde anlatmaya çalışmak yerine, her varyant için ayrı URL + ayrı Product şeması oluşturun ya da ProductGroup türünü kullanın.

GTIN zorunluluğu: Google, ürün sonuçlarında GTIN (EAN, UPC, ISBN) bilgisi olan ürünlere öncelik tanır. Mümkün olan her ürün için gtin13, gtin12 veya mpn alanlarını doldurun.

Stok bilgisinin doğruluğu: "availability": "https://schema.org/InStock" yazarken gerçekten stokta olmayan ürünler için bu değeri kullanmak, Google’ın politikalarını ihlal eder ve manuel işleme yol açabilir. OutOfStock veya PreOrder değerlerini doğru durumda kullanın.

Sık Sorulan Sorular

Bir sayfada kaç JSON-LD bloğu olabilir? Teknik olarak sınır yoktur. Google birden fazla bloğu okuyabilir; ancak bunları @graph ile tek blokta birleştirmek hem daha temiz hem de test etmesi daha kolaydır.

Schema eklemek sıralamayı doğrudan artırır mı? Schema.org, doğrudan bir sıralama faktörü değildir. Ancak rich result üretmesi, CTR’ı artırması ve Google’ın içeriği daha iyi anlamasını sağlaması dolaylı olarak SEO’yu etkiler. Özellikle rekabetçi kategorilerde aynı sıraya sahip iki sayfa arasında şemalı olan sayfanın daha yüksek tıklama oranı aldığı A/B testlerle kanıtlanmıştır.

Şema ekledim ama rich result çıkmıyor, neden? Rich result çıkması için şemanın geçerli olması gereklidir; ancak bu yeterli değildir. Google sayfanın içeriğini yeterince güvenilir bulmuyorsa, site otoritesi düşükse veya o rich result türü için yeterli sayfaya sahip değilseniz görünmeyebilir. Ayrıca yeni eklenen şemaların SERP’te görünmesi birkaç haftayı bulabilir.

Şema ile canonical etiket çelişirse ne olur? Canonical etiket, hangi URL’nin “ana” sayfa olduğunu belirtir. JSON-LD içindeki @id ve mainEntityOfPage alanlarının canonical URL ile aynı olmasına özen gösterin; aksi hâlde Google hangi sürümü işaretleyeceği konusunda kararsız kalabilir.

Rakibim şema kullanmıyor, ben kullansam avantaj sağlar mıyım? Evet. Rich result CTR’ı artırır, bu da trafiği artırır. Aynı sıralamada iki sayfa varsa şemalı olan genellikle daha dikkat çekici görünür. Ancak şema tek başına sıralama farkı yaratmaz; içerik kalitesi, backlink profili ve teknik SEO sağlığı çok daha belirleyicidir.

Schema Denetim Kontrol Listesi

Mevcut bir siteye schema eklemeden veya mevcut şemanızı gözden geçirmeden önce şu kontrol listesini uygulayın:

Her sayfa türü için doğru @type seçildi mi?
Zorunlu alanların tamamı eksiksiz mi?
Tarih alanları ISO 8601 formatında mı? (2026-07-13T09:00:00+03:00)
image URL’leri gerçekten erişilebilir mi? (Kırık görsel bağlantısı hataya yol açar)
aggregateRating için en az 5 gerçek yorum mevcut mu?
Sayfadaki içerik ile şema verileri birbiriyle tutarlı mı?
NAP bilgileri Google Business Profile ile aynı mı?
sameAs alanlarında geçerli, erişilebilir URL’ler var mı?
Rich Results Test’te herhangi bir hata (error) yok mu?
GSC Geliştirmeler raporu düzenli olarak takip ediliyor mu?

Bu kontrol listesini yeni sayfa açılışlarında, site taşımalarında ve içerik güncellemelerinden sonra tekrar çalıştırın.

Sonuç

Schema.org, tek başına SEO’nun gümüş kurşunu değildir; ancak doğru uygulandığında görünürlük ve tıklama oranı üzerinde ölçülebilir bir etki yaratır. Bu sözlük, ihtiyacınız olduğunda başvurabileceğiniz bir referans noktası olarak tasarlandı.

Yapısal veri stratejinizi profesyonel destek alarak oluşturmak istiyorsanız Teknik SEO hizmetlerimizi inceleyebilirsiniz. Sağlık sektörü için özel uygulama rehberine ise Sağlık Turizmi SEO sayfamızdan ulaşabilirsiniz.

Her schema türünün güncel spesifikasyonunu her zaman schema.org adresinden ve Google’ın Search Central dokümantasyonundan takip edin; çünkü bu alan sürekli gelişmektedir.