Yapılandırılmış Veri ve Schema Markup Nedir, Nasıl Eklenir?

Kısa cevap: Yapılandırılmış veri, bir sayfadaki bilgileri (kuruluşun adı, işletmenin adresi, makalenin yazarı, sayfanın site içindeki yolu gibi) arama motorlarının standart bir biçimde okuyabileceği şekilde işaretleyen koddur. Schema markup, bu işaretlemenin schema.org sözlüğü kullanılarak yapılmasıdır. Google üç biçimi destekler ve genel olarak JSON-LD’yi önerir. Doğru işaretleme sayfayı desteklenen zengin sonuçlara uygun hale getirir ve sayfanın içeriğinin doğru anlaşılmasına yardım eder; bunun için işaretlenen her bilginin sayfada da görünmesi gerekir.

Bir denetim raporundaki “schema eksik” tespiti, yapılacak işi tek başına tanımlamaz. Ekibinizin hangi sayfada hangi bilgiyi işaretleyeceğini, verinin nereden geleceğini ve sonucun nasıl doğrulanacağını belirlemesi gerekir; iş de sitedeki mevcut işaretlemenin incelenmesiyle başlar.

Bu yazıda yapılandırılmış verinin ne olduğunu, aramada neyi değiştirdiğini, sayfa türüne göre hangi işaretlemenin seçildiğini, dört temel türün JSON-LD örneklerini ve işaretlemenin nasıl eklenip doğrulandığını sırasıyla anlatıyoruz. Yapılandırılmış veri, SEO çalışmasının teknik temelinin bir parçasıdır.

Yapılandırılmış veri nedir

Google, yapılandırılmış veriyi sayfa hakkında bilgi vermek ve sayfanın içeriğini sınıflandırmak için kullanılan standart bir biçim olarak tanımlar. Bir ziyaretçi, iletişim sayfasındaki satırın işletmenin adresi olduğunu sayfanın düzeninden anlar. Arama motoru için aynı bilgiyi kesinleştiren şey, o satırın “adres” olarak etiketlenmesidir.

Bu etiketleme iki kavramla yapılır. Tür, işaretlemenin neyi anlattığını belirtir; Organization kuruluşu, LocalBusiness yerel işletmeyi, Article makaleyi, Product ürünü tanımlar. Özellik ise o şeye ait bilgiyi taşır; bir kuruluşta name adı, url web adresini, logo logoyu, bir makalede headline başlığı, author yazarı, datePublished yayın tarihini gösterir.

Schema markup ve schema.org ilişkisi

Schema.org, türlerin ve özelliklerin ortak sözlüğüdür. Büyük arama motorlarının birlikte başlattığı bu sözlük sayesinde aynı bilgi her sitede aynı adla anlatılır. Schema markup ise bu sözlüğün bir sayfaya uygulanmış halidir. Günlük kullanımda “schema eklemek”, “yapılandırılmış veri eklemek” ve “schema markup” aynı işi anlatır.

Schema.org’daki her tür, Google’da özel bir görünüme karşılık gelmez. Sözlük çok geniş bir tür yelpazesini kapsar; Google’ın arama sonuçlarında özel olarak kullandığı türler ise yapılandırılmış veri galerisinde listelenir. Ekibiniz veri modelini schema.org tanımlarına, arama görünümüyle ilgili kararları Google belgelerine göre kurar.

JSON-LD, Microdata ve RDFa

Google üç biçimi destekler:

• JSON-LD: İşaretleme, sayfanın HTML’inde ayrı bir script bloğunda durur; sayfanın görünen metnine karışmaz.
• Microdata ve RDFa: Bilgiler, sayfadaki HTML öğelerine eklenen niteliklerle işaretlenir.

Google genel olarak JSON-LD’yi önerir ve üç biçimin de geçerli olduğu sürece eşit ölçüde uygun olduğunu belirtir. JSON-LD, işaretlemeyi görünür HTML öğelerinden ayrı tuttuğu için bakımı kolaylaştırır; yine de tema ve şablon değişikliklerinden sonra üretilen çıktıyı yeniden kontrol etmeniz gerekir. Sitenizde kurallara uygun bir Microdata uygulaması varsa yalnız biçim için değiştirmek öncelikli bir iş değildir.

Yapılandırılmış veri aramada neyi değiştirir

Zengin sonuçlara uygunluk

Zengin sonuç, standart başlık ve açıklamanın yanında sayfa yolu, ürün fiyatı ve stok durumu, etkinlik tarihi ya da tarif süresi gibi ek bilgiler gösteren arama sonucudur. Bu görünümlerin çoğu, ilgili yapılandırılmış verinin sayfada bulunmasına dayanır.

Burada iki kavram ayrı tutulur. Uygunluk, işaretlemenin geçerli olması, zorunlu özellikleri taşıması ve Google’ın kurallarına uyması demektir. Gösterim ise Google’ın kararıdır; Google, Zengin Sonuç Testi’nden geçen işaretlemenin de sonuçlarda gösterileceğini garanti etmez. Bu nedenle ekibinizle kabul ölçütünü “zengin sonuç çıktı” yerine “doğru tür, eksiksiz zorunlu alan, sayfayla birebir uyum, Google’ın işaretlemeyi bulabilmesi” olarak tanımlamak daha sağlıklıdır.

Google’ın yapılandırılmış veri belgeleri sıralama artışından söz etmez. İşaretlemenin işlevi, içeriği anlaşılır kılmak ve sayfayı desteklenen görünümlere hazırlamaktır.

Sayfanın ve işletmenin doğru anlaşılması

Yapılandırılmış verinin ikinci işlevi, sayfadaki bilgilerin belirsizlik bırakmadan okunmasıdır. Organization işaretlemesi işletmenizin adını, web adresini ve logosunu tek bir tanımda toplar. Google, logo özelliğinin arama sonuçlarında ve bilgi panelinde gösterilecek logoyu belirlemeye yardım ettiğini belirtir.

sameAs özelliği, aynı kuruluşu anlatan başka sayfaları (resmi sosyal medya hesapları, kurumsal profiller) listeler. Burada ölçüt bağlantı sayısı değil, kimliğin eşleşmesidir: listeye yalnız işletmenize ait olduğu doğrulanmış profiller girer.

Yapay zeka özellikleriyle ilişkisi

Google, AI Overviews (yapay zeka özetleri) ve AI Mode’da (yapay zeka modu) görünmek için ek bir gereklilik, yeni bir makine okunur dosya ya da özel bir schema.org işaretlemesi gerekmediğini açıkça belirtir. Aynı belge, önerilen uygulamalar arasında yapılandırılmış verinin sayfadaki görünür metinle eşleşmesini sayar.

Google’ın yapay zeka özellikleri için de geçerli olan ölçüt, sağlam bir SEO temelidir. Google’a göre bu özelliklerde kaynak olarak gösterilebilmenin teknik koşulu, sayfanın dizinde bulunması ve arama sonuçlarında açıklama metniyle gösterilmeye uygun olmasıdır. Taranabilir sayfa, açık içerik ve sayfayla uyumlu işaretleme bu temelin parçalarıdır. Öteki yapay zeka platformlarının koşullarını ise kendi belgelerine göre değerlendirirsiniz. Yapay zeka yanıtlarındaki görünürlük, SEO’nun üzerine kurulan ölçülebilir ek bir çalışmadır; bu çalışmanın adımları GEO yol haritasında sırasıyla yer alır.

Sayfa türüne göre hangi işaretleme seçilir

Doğru türü sayfanın asıl konusu belirler. Tüm sayfalara aynı kodu eklemek yerine siteyi şablon şablon ele almanız gerekir.

Sayfa türü	Uygun tür	Öne çıkan özellikler	Not
Ana sayfa ya da hakkımızda	Organization	name, url, logo, sameAs	Zorunlu özellik yok; ilgili özellikler eklenir. Tek bir sayfada yeterlidir.
Fiziksel konumu olan işletme sayfası	LocalBusiness ya da en uygun alt türü	name, address (zorunlu), url, openingHoursSpecification	Mümkün olan en özel alt tür seçilir (ör. Restaurant, Dentist).
Blog yazısı, haber	Article, BlogPosting	headline, author, image, datePublished, dateModified	Zorunlu özellik yok; tarihler ve yazar sayfada da görünür.
Kategori altındaki iç sayfalar	BreadcrumbList	itemListElement, name, item, position	En az iki basamak; sayfadaki gezinme yoluyla aynı.
Ürün sayfası	Product	ad, görsel, fiyat ve stok bilgisi	E-ticarete özgü ayrıntılar ayrı ele alınır.
Etkinlik, iş ilanı, video	Event, JobPosting, VideoObject	türün belgesindeki zorunlu alanlar	Galerideki güncel koşullar izlenir.

Ekibinizle bu tablonun sitenize özel bir sürümünü hazırlamanız bakımı kolaylaştırır; her şablon için adını, seçilen türü, verinin geldiği yeri (yönetim paneli, tema ayarı ya da eklenti) ve sorumlu kişiyi yazarsınız. Tema ya da eklenti değiştiğinde hangi alanı kontrol edeceğinizi bu kayıttan okursunuz.

Yapılandırılmış veri örnekleri

Aşağıdaki örnekler kurgusal bir işletme (“Örnek Mimarlık Ofisi”) için hazırlanmıştır ve geçerli JSON-LD’dir. Kendi sitenizde her alanı sayfanızda görünen bilgiyle değiştirmeniz gerekir.

Organization örneği

Ana sayfaya ya da hakkımızda sayfasına eklenir.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example.com/#organization",
  "name": "Örnek Mimarlık Ofisi",
  "url": "https://www.example.com/",
  "logo": "https://www.example.com/images/logo.png",
  "email": "[email protected]",
  "sameAs": [
    "https://profil.example.net/ornek-mimarlik-ofisi"
  ]
}

name sitede kullanılan kuruluş adıyla, logo sitedeki logoyla aynıdır. Google, logo görselinin en az 112×112 piksel ve taranabilir olmasını ister. @id, bu kuruluş tanımına sitenin başka sayfalarından atıf yapmayı kolaylaştıran sabit bir kimliktir.

LocalBusiness örneği

Ziyaretçi kabul eden bir ofisin, mağazanın ya da şubenin sayfasına eklenir.

{
  "@context": "https://schema.org",
  "@type": "ProfessionalService",
  "name": "Örnek Mimarlık Ofisi",
  "url": "https://www.example.com/iletisim/",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Örnek Caddesi No: 1",
    "addressLocality": "İstanbul",
    "addressCountry": "TR"
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "18:00"
    }
  ]
}

name ve address zorunludur. Google’ın önerdiği özellikler arasında telefon, konum koordinatları (geo) ve fiyat aralığı da bulunur; hangisini eklerseniz ekleyin, aynı bilgi sayfada da yazılı olmalıdır. Çalışma saatleri değiştiğinde işaretlemenin de güncellenmesi gerekir; bu nedenle verinin site yönetim panelindeki tek bir alandan gelmesi bakımı kolaylaştırır.

Article örneği

Blog yazısı ya da haber sayfasına eklenir.

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Ofis Tasarımında Doğal Işık Planlaması",
  "image": [
    "https://www.example.com/images/dogal-isik.jpg"
  ],
  "datePublished": "2026-10-01T09:00:00+03:00",
  "dateModified": "2026-10-20T14:30:00+03:00",
  "author": {
    "@type": "Person",
    "name": "Yazar Adı",
    "url": "https://www.example.com/ekip/yazar-adi/"
  },
  "publisher": {
    "@type": "Organization",
    "@id": "https://www.example.com/#organization",
    "name": "Örnek Mimarlık Ofisi",
    "url": "https://www.example.com/"
  }
}

Article için zorunlu özellik yoktur; Google başlık, görsel, yayın ve güncelleme tarihleri ile yazarın adı ve sayfası gibi özellikleri önerir. Tarihler saat dilimiyle birlikte ISO 8601 biçiminde yazılır ve sayfada görünen tarihlerle aynıdır. publisher alanında kuruluşun kısa bir tanımı (tür, ad, web adresi) yer alır; @id değeri Organization örneğindekiyle aynı tutulur. Google yapılandırılmış veriyi sayfa sayfa okuduğu için yayıncının adını her yazıda bu kısa tanımla vermeniz, tam kuruluş tanımını ise ana sayfada tutmanız uygun olur.

BreadcrumbList örneği

Kategori yapısındaki iç sayfalara eklenir.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Blog",
      "item": "https://www.example.com/blog/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Ofis Tasarımı",
      "item": "https://www.example.com/blog/ofis-tasarimi/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Ofis Tasarımında Doğal Işık Planlaması"
    }
  ]
}

Liste en az iki basamaktan oluşur ve sayfanın üstündeki görünür gezinme yoluyla aynı sırayı izler. Son basamak bulunulan sayfa olduğu için item adresi gerekmez. Google’ın belgesi bu görünümün masaüstü sonuçlarda kullanıldığını belirtir.

Yapılandırılmış veri nasıl eklenir

Kodla ekleme

JSON-LD, sayfanın HTML’ine <script type="application/ld+json"> etiketi içinde eklenir. Etiket head ya da body bölümünde yer alabilir. Aynı sayfada birden fazla tür bulunabilir; bir blog yazısında Article ve BreadcrumbList birlikte kullanılır.

İyi bir uygulamada işaretleme elle yazılmaz, şablondan üretilir: başlık, tarih, yazar ve görsel alanları sayfanın kendi verisinden okunur. Böylece içerik güncellendiğinde işaretleme de kendiliğinden güncellenir. Google, JavaScript ile sayfaya sonradan eklenen yapılandırılmış veriyi de okuyabilir; bu yöntem kullanılıyorsa ekibiniz, Google’ın oluşturduğu sayfada işaretlemenin bulunduğunu URL Denetimi ya da Zengin Sonuç Testi ile doğrular.

WordPress sitelerde

WordPress sitelerde yapılandırılmış veri çoğunlukla SEO eklentisi ya da tema tarafından üretilir. Burada iki kontrol öne çıkar:

• Tek kaynak: Tema ve eklenti aynı türü (ör. iki ayrı Organization ya da Article) ayrı ayrı üretiyorsa, sorumluluğu birine verip diğerinin çıktısını kapatırsınız.
• Alan uyumu: Eklentinin kuruluş adı, logo, yazar ve tarih alanlarının sitede görünen bilgilerle aynı olduğunu doğrularsınız.

Bir sayfada birden fazla türün bulunması olağandır; incelemenin konusu, aynı kuruluşun ya da makalenin iki kez ve birbiriyle çelişen alanlarla tanımlanmasıdır.

Eklentinin genel ayarları için WordPress SEO ayarları rehberi adım adım bir yol sunar. Ekibiniz incelemeyi her durumda eklentinin ayar ekranından değil, sayfanın gerçek çıktısından yapar.

İşaretlemede uyulacak kurallar

Google’ın genel yönergeleri dört ilkede toplanır:

1. Görünür içerik: İşaretlenen bilgi ziyaretçinin gördüğü sayfada yer alır.
2. Gerçek temsil: İşaretleme sayfanın gerçek içeriğini anlatır; sayfada olmayan bir konuyu ya da yanıltıcı bilgiyi içermez.
3. Eksiksiz zorunlu alanlar: İlgili türün zorunlu özellikleri verilir; önerilen özellikler sonucu zenginleştirir.
4. Doğru sayfa: İşaretleme, anlattığı içeriğin bulunduğu sayfada durur; yalnız işaretleme taşımak için ayrı bir sayfa açılmaz.

Bu dört ilke içerik uyumunu özetler; zengin sonuç uygunluğunu değerlendirirken sayfanın taranabilirliğini, dizine eklenebilirliğini ve ilgili türün güncel Google koşullarını da kontrol etmeniz gerekir. Kurallara aykırı işaretleme manuel işleme yol açabilir; Google’a göre bu işlem sayfanın zengin sonuç uygunluğunu kaldırır, sıralamasını değiştirmez. Durumu Search Console’daki Manuel işlemler raporundan izlersiniz.

Doğrulama ve yayın sonrası takip

Doğrulama tek bir test değil, sıralı bir kontroldür:

Adım	Araç	Neye bakılır
Geliştirme sırasında	Zengin Sonuç Testi	Google’ın desteklediği türlerde hata ve uyarı
Sözdizimi kontrolü	Schema Markup Validator	Tüm schema.org türlerinde yapının geçerliliği
Yayın sonrası	Search Console zengin sonuç raporları	Desteklenen türlerde geçerli ve hatalı sayfalar
Tek sayfa incelemesi	URL Denetimi	Google’ın sayfada işaretlemeyi bulup bulmadığı
Etki değerlendirmesi	Performans raporu	Değişiklik öncesi ve sonrası dönemlerin karşılaştırması

Zengin Sonuç Testi yalnız Google’ın desteklediği türleri değerlendirir; Schema Markup Validator ise schema.org sözlüğünün tamamını denetler. Bir tür Validator’da hatasız görünse de Google’da özel bir görünüme karşılık gelmeyebilir. Geçerli bir kod, bilginin doğru olduğunu da tek başına göstermez; bu yüzden ekibiniz işaretlenen bilgileri sayfadaki içerikle ayrıca karşılaştırır.

Etki değerlendirmesinde aynı dönemde yapılan içerik değişiklikleri ve mevsimsellik hesaba katılır; fark yalnız işaretlemenin yayın tarihine bağlanmaz. Bu kontroller, teknik SEO kontrol listesindeki düzenli bakım takviminin bir parçası olarak yürütülür.

FAQ ve HowTo işaretlemelerinin güncel durumu

Eski SEO rehberlerinde sık önerilen iki işaretlemenin durumu değişti:

• HowTo: Google, adım adım anlatım (HowTo) zengin sonucunu Eylül 2023’te masaüstü ve mobil sonuçlardan kaldırdı.
• FAQ: Sık sorulan sorular (FAQ) zengin sonucu Eylül 2023’ten itibaren yalnız tanınmış, otoriter devlet ve sağlık sitelerinde gösteriliyordu. Google, Mayıs 2026’da bu sonucun artık gösterilmediğini duyurdu ve Haziran 2026’da belgesini kaldırdı.

Aynı dönemde başka türler de galeriden çıktı: site bağlantıları arama kutusu (2024), kurs bilgisi, tahmini maaş, öğrenme videosu, özel duyuru ve araç ilanı (2025), alıştırma problemi (2026). Bu değişikliklerin listesi Google Search Central’ın belge güncellemeleri sayfasında tutulur. Adları birbirine yakın özellikler ayrı değerlendirilir: kaldırılan kurs bilgisi (Course info) ile galeride kalan kurs listesi (Course list) farklı görünümlerdir.

Bu durum, sayfadaki içeriğin değerini değiştirmez. Okurun sorularını yanıtlayan bir SSS bölümü ya da adım adım bir anlatım, ziyaretçi için yararlı olmaya devam eder. Değişen, bu içeriklerin aramada özel bir görünüm almamasıdır. Soru-cevap için kullanılan QAPage türü ise sitenin kendi yazdığı SSS’ye karşılık gelmez; kullanıcıların yanıt gönderebildiği, tek bir soruya odaklanan forum ve destek sayfaları içindir. Ekibiniz sitedeki işaretlemeyi bu güncel listeye göre gözden geçirir ve galeriyi düzenli aralıklarla kontrol eder.

Sık sorulan sorular

Yapılandırılmış veri sıralamayı etkiler mi?

Doğrudan bir sıralama etkisi beklenmez. Etkiyi, işaretlemenin yayına girdiği sayfalarda Search Console Performans raporuyla önceki dönemle karşılaştırarak izlersiniz; zengin sonuç görünümleri de bu raporda arama görünümü filtresiyle ayrıca incelenebilir.

Her sayfaya Organization eklenmeli mi?

Gerekmez. Google, Organization işaretlemesini ana sayfaya ya da kuruluşu anlatan tek bir sayfaya eklemeyi önerir. Blog yazılarında kuruluşu yalnız yayıncı olarak, ad ve web adresiyle kısaca anmanız yeterlidir.

Yapılandırılmış veri olmadan zengin sonuç çıkar mı?

Ürün, etkinlik ve sayfa yolu gibi zengin sonuçlar, Google’ın belgelerinde ilgili türün yapılandırılmış verisine bağlı olarak anlatılır. Hangi türün hangi görünümü desteklediği Google’ın yapılandırılmış veri galerisinde listelenir.

İşaretleme ne sıklıkla kontrol edilmeli?

İşaretlemeyi ilk yayında, tema ya da eklenti değişikliğinde ve şablon güncellemesinde kontrol edersiniz; ara dönemde Search Console raporlarını ve Google’ın galerisindeki değişiklikleri izlersiniz.

Sonuç

Yapılandırılmış veri, sitenizin anlattığı bilgileri arama motorlarına kesin ve standart bir dille aktarır. İyi bir uygulama sayfa türüne uygun işaretlemeyle başlar, görünür içerikle birebir uyumu korur ve yayından sonra düzenli olarak doğrulanır. Peaktimize olarak yapılandırılmış veriyi teknik SEO çalışmasının bir parçası olarak ele alıyoruz; sitenizin mevcut işaretlemesini değerlendirmek için SEO hizmetimizi inceleyebilirsiniz.

Kaynaklar

• Google Search Central: Yapılandırılmış verilere giriş
• Google Search Central: Genel yapılandırılmış veri yönergeleri
• Google Search Central: Yapılandırılmış veri galerisi
• Google Search Central: AI özellikleri ve web siteniz
• Google Search Central: Organization, LocalBusiness, Article, Breadcrumb
• Google Search Central: JavaScript ile yapılandırılmış veri oluşturma
• Google Search Central: Belge güncellemeleri
• Google Search Central Blog: HowTo ve FAQ zengin sonuçlarındaki değişiklikler
• Schema.org