Schema Markup: SEO için Yapılandırılmış Veriye Uygulamalı Rehber

Kısaca: Schema markup, bir sayfayı schema.org sözlüğüyle tanımlayan koddur (genellikle bir JSON-LD betiği). Böylece arama motorları sayfanın içeriğini tam olarak bilir: bir ürün ve fiyatı, bir makale ve yazarı, bir işletme ve adresi. Google'da sayfaları fiyat, yorum yıldızı ve içerik haritası (breadcrumb) gibi zengin sonuçlar için uygun hale getirir; ancak bunları garanti etmez ve bir sıralama artışı sağlamaz. Mayıs 2026'da SSS dahil birçok zengin sonuç kaldırıldı. Bu yüzden Google'ın hâlâ desteklediği türleri işaretleyin, işaretlemeyi ziyaretçilerin gördüğüyle birebir aynı tutun ve her şablon değişikliğinden önce ve sonra test edin.

"Schema'sı var" denen sitelerin çoğunda iki sorundan biri görülür: Yıllar önce Google'ın artık göstermediği bir zengin sonuç için eklenmiş işaretleme ya da tema, eklenti ve uygulamanın her birinin kendi, birbiriyle çelişen bloğunu eklemesi. Bu rehber yapılandırılmış verinin bugün ne işe yaradığını, Ekim 2026 itibarıyla emeğe değer türleri, kopyalamaya hazır JSON-LD örneklerini ve bir test rutinini kapsıyor.

Schema markup nedir

Schema.org, web'deki varlıkları tanımlamak için kullanılan ortak bir sözlüktür; Google, Microsoft, Yahoo ve Yandex tarafından kurulmuş ve bir topluluk projesi olarak sürdürülmektedir. Türleri (Product, Article, LocalBusiness, Event) ve her türün sahip olabileceği özellikleri (price, author, address, startDate) tanımlar. Schema.org'a göre 2024 itibarıyla 45 milyondan fazla alan adı bunu kullanıyor.

"Yapılandırılmış veri", makinelerin tahmin yürütmeden okuyabildiği sabit biçimli bilgiler için kullanılan genel terimdir. "Schema markup" ise schema.org sözlüğüyle yazılmış yapılandırılmış veridir. Pratikte iki terim birbirinin yerine kullanılır.

İşaretleme olmadan bir arama motoru "kupa" kelimesinin yanındaki "$32" ifadesini görür ve bunun muhtemelen bir fiyat olduğunu çıkarır. İşaretlemeyle sayfa bunu açıkça söyler: Bu, adı "Speckled Stoneware Mug" olan, 32.00 USD fiyatla satılan, stokta bulunan bir Product'tır. Google'ın yapılandırılmış veriye giriş sayfası amacı şöyle tarif eder: Google, bir sayfanın içeriğini anlamak için yapılandırılmış veriyi kullanır ve bu, kullanıcılar için daha çekici arama sonuçlarının önünü açabilir.

JSON-LD, Microdata ve RDFa

Google Search üç biçimi destekler. Hepsi aynı sözlüğü ifade eder; farkları bilginin nerede durduğundadır.

Google, site yapınız izin veriyorsa genel olarak JSON-LD'yi önerdiğini belirtir. Yeni her şey için JSON-LD kullanın. Platformunuz zaten doğru Microdata üretiyorsa onu yeniden yazmanız için bir neden yok; ancak aynı öğeyi farklı biçimde tanımlayan bir JSON-LD bloğunu bunun üstüne eklemeyin.

Yapılandırılmış veri ne yapar, ne yapmaz

Sayfaları zengin sonuçlar için uygun hale getirir. Zengin sonuçlar, geliştirilmiş arama listelemeleridir: ürün fiyatı ve stok durumu, yorum yıldızları, çıplak bir URL yerine breadcrumb yolu, video küçük resimleri, etkinlik tarihleri. Google'ın dokümantasyonunda zengin sonuçların tıklama oranını artırdığı vaka çalışmaları yer alır; örneğin Rotten Tomatoes, yapılandırılmış veri içeren sayfalarda %25 daha yüksek tıklama oranı ölçmüştür.

Hiçbir şeyi garanti etmez. Google'ın genel yapılandırılmış veri yönergeleri, yapılandırılmış verinizin arama sonuçlarında görüneceğini garanti etmediğini belirtir. Geçerli işaretleme bir sayfayı uygun hale getirir; zengin sonucun fayda sağlayıp sağlamadığına Google her sorgu için yine kendisi karar verir.

Sıralama için kestirme yol değildir. Google, yapılandırılmış veriyi içeriği anlamanın ve arama özelliklerine hak kazanmanın bir yolu olarak çerçeveler. En net işaret, kötüye kullanımı nasıl ele aldığıdır: yapılandırılmış veri için verilen bir manuel işlem, sayfanın zengin sonuç uygunluğunu kaybetmesi anlamına gelir ve Google bunun sayfanın web aramasındaki sıralamasını etkilemediğini söyler.

Belirsizliği gidermeye yardımcı olur. Google'ın Organization dokümantasyonuna göre Organization işaretlemesi, Google'ın kurumsal bilgilerinizi anlamasına ve kuruluşunuzu diğerlerinden ayırmasına yardımcı olur; ayrıca arama sonuçlarında ve bilgi panellerinde hangi logonun görüneceğini etkileyebilir.

Google'ın hâlâ desteklediği zengin sonuçlar (Ekim 2026)

Google üç yıldır listeyi budaıyor. Kaldırılmış bir özellik için yazılmış işaretleme zararlı değildir, ama boşa bakım yüküdür ve bazı eklentiler bunların bir kısmını hâlâ varsayılan olarak üretir.

Kaldırılan veya kısıtlanan özellikler

Google sitelinks search box'ı kaldırırken, desteklenmeyen yapılandırılmış verinin Search'te sorun yaratmadığını, dolayısıyla işaretlemeyi silmeye gerek olmadığını söyledi. Aynı mantık diğerleri için de geçerli: Şablona bir sonraki dokunuşunuzda temizleyin, ama telaşlanmayın.

Çoğu site için kullanmaya değer türler

En son Ekim 2026'da güncellenen arama galerisi, Google'ın şu anda desteklediği özellikleri listeler. Çoğu işletmenin kullanabileceği türler şunlar:

Galeri ayrıca iş ilanlarını, veri kümelerini, tartışma forumlarını, Soru-Cevap sayfalarını, profil sayfalarını, filmleri, tatil kiralamalarını, ücretli duvar arkasındaki içerikleri ve birkaç türü daha kapsar. Başlamadan önce dokümanlardan bilmeye değer iki kural var: Yalnızca çevrimiçi etkinlikler Event zengin sonuçları için uygun değildir, bunlar için fiziksel bir konum gerekir; artılar ve eksiler görünümü ise yalnızca editoryal ürün incelemeleri içindir, satıcı sayfaları için değil.

Kopyalamaya hazır JSON-LD örnekleri

Her blok, sayfanın HTML'inde, genellikle head içinde <script type="application/ld+json"> etiketinin içine yerleştirilir. Her değeri kendi gerçek verinizle değiştirin ve yalnızca sayfanın gerçekten gösterdiği şeyleri işaretleyin.

Organization (ana sayfa)

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example.com/#organization",
  "name": "Copperleaf Ceramics",
  "url": "https://www.example.com/",
  "logo": "https://www.example.com/images/logo-512.png",
  "description": "Handmade stoneware mugs, plates and bowls, shipped across the United States.",
  "email": "[email protected]",
  "sameAs": [
    "https://www.instagram.com/example",
    "https://www.linkedin.com/company/example"
  ]
}

Google, Organization işaretlemesinin her sayfaya değil, ana sayfaya veya kuruluşu anlatan tek bir sayfaya konmasını önerir. Logo yönergeleri; taranabilir, dizine eklenebilir ve beyaz arka planda doğru görünen, en az 112×112 piksellik bir görsel ister. sameAs, sizi tanımlayan diğer sitelerin URL'lerini alır; örneğin sosyal medya veya yorum profilleri. Google ayrıca vatID ve iso6523Code gibi tanımlayıcıları, bunlara sahip kuruluşlar için listeler.

LocalBusiness (lokasyon sayfası)

{
  "@context": "https://schema.org",
  "@type": "Bakery",
  "name": "North Street Bakery",
  "url": "https://www.example.com/locations/north-street",
  "telephone": "+1-555-010-0199",
  "priceRange": "$$",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "120 North Street",
    "addressLocality": "Springfield",
    "addressRegion": "IL",
    "postalCode": "62701",
    "addressCountry": "US"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 39.80172,
    "longitude": -89.64371
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "07:00",
      "closes": "18:00"
    },
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": "Saturday",
      "opens": "08:00",
      "closes": "14:00"
    }
  ]
}

Google'ın yerel işletme rehberi, düz LocalBusiness yerine mevcut en spesifik alt türü (Bakery, Dentist, HealthClub), en az beş ondalık basamaklı enlem ve boylamı, ülke ve alan kodlu bir telefon numarasını ve 100 karakterden kısa bir priceRange değerini ister. Bilgileri Google İşletme Profilinizle birebir aynı tutun; bu tarafı Google İşletme Profili optimizasyonu rehberimiz ele alıyor.

Teklif içeren Product (merchant listing)

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Speckled Stoneware Mug, 12 oz",
  "image": [
    "https://www.example.com/images/mug-1x1.jpg",
    "https://www.example.com/images/mug-4x3.jpg",
    "https://www.example.com/images/mug-16x9.jpg"
  ],
  "description": "Wheel-thrown stoneware mug with a speckled glaze. Dishwasher safe.",
  "sku": "MUG-SPK-12",
  "brand": {
    "@type": "Brand",
    "name": "Copperleaf Ceramics"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/shop/speckled-mug",
    "price": "32.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "14"
  }
}

Merchant listing rehberi; name, image ve price ile priceCurrency (üç harfli ISO 4217 kodu) içeren bir offers nesnesi ister. Stok durumunu, ürün durumunu, markayı, varsa GTIN'i, kargo bilgilerini ve iade politikasını önerir. Schema.org price tanımı, ondalık ayırıcı olarak nokta kullanılan düz bir sayı ve para biriminin değerin içindeki "$" yerine priceCurrency içinde belirtilmesini ister. İndirimlerde Google artık satış dönemini tanımlamak için validFrom ile birlikte validThrough veya priceValidUntil kullanımını belgeliyor. Google ayrıca hem sayfa içi işaretlemenin hem de bir Merchant Center feed'inin gönderilmesinin alışveriş deneyimleri için uygunluğu en üst düzeye çıkardığını söylüyor.

Article (blog yazısı)

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "How to Care for Handmade Stoneware",
  "image": ["https://www.example.com/images/stoneware-care-16x9.jpg"],
  "datePublished": "2026-09-14T08:00:00+00:00",
  "dateModified": "2026-10-02T09:30:00+00:00",
  "author": [
    {
      "@type": "Person",
      "name": "Maya Lindqvist",
      "url": "https://www.example.com/about/maya"
    }
  ],
  "publisher": {
    "@id": "https://www.example.com/#organization"
  }
}

Article rehberinde zorunlu özellik yoktur; yazar, tarihler, başlık ve görsel önerilir. author.name alanına yalnızca kişinin adını yazın; unvan veya "yazan" gibi ifadeler eklemeyin ve her yazar için ayrı bir kayıt verin. Buradaki publisher, Organization bloğuna @id ile işaret eder; böylece ikisi birbirinden bağımsız iki varlık yerine tek bir bağlantılı varlığı tanımlar.

BreadcrumbList

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Shop",
      "item": "https://www.example.com/shop"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Mugs",
      "item": "https://www.example.com/shop/mugs"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Speckled Stoneware Mug"
    }
  ]
}

Breadcrumb rehberine göre bir yol en az iki öğe içermelidir, son öğede item atlanabilir (Google bu durumda sayfanın kendi URL'sini kullanır) ve yol, URL klasörlerinizi yansıtmak yerine tipik bir kullanıcının sayfaya ulaşırken izlediği yolu izlemelidir.

Blokları tek bir graph'ta bağlamak

Bir sayfa çoğu zaman birkaç şeyi tanımlar: sayfanın kendisini, arkasındaki kuruluşu, bir ürünü, breadcrumb yolunu. Google'ın yönergelerine göre Google, bir sayfadaki birden fazla öğeyi iç içe de verseniz ayrı ayrı da belirtseniz anlar ve ayrı blokları @id ile bağlayabilirsiniz. Birçok WordPress kurulumu bunu zaten yapıyor: Örneğin Yoast SEO, WebPage, WebSite, Organization veya Person, Article ve BreadcrumbList'in birbirine @id ile atıf yapan ayrı düğümler olduğu tek bir @graph çıktısı verir.

Buradan iki pratik kural çıkar. Organization'ınıza tek ve sabit bir @id verin ve ayrıntıları tekrar etmek yerine her yerde ona atıf yapın. Ayrıca Google'ın yönergelerinin istediği gibi, VideoObject gibi ikincil öğelere ek olarak sayfanın ana öğesini, yani bir Product'ı veya Recipe'yi de işaretleyin.

Schema markup ve yapay zeka araması

Birçok tavsiye, schema'nın yapay zeka yanıtlarının anahtarı olduğunu iddia ediyor. Google'ın AI özellikleri ve web siteniz hakkındaki kendi rehberi net: AI Overviews veya AI Mode'da görünmek için eklemeniz gereken özel bir schema.org yapılandırılmış verisi yoktur ve yeni makine tarafından okunabilir dosyalara da ihtiyacınız yoktur. Listelenen en iyi uygulamalar arasında yapılandırılmış verinizin sayfadaki görünür metinle eşleştiğinden emin olmak da var.

Diğer asistanlar da işaretleme gereksinimleri yayımlamadı. Yapılandırılmış verinin güvenilir biçimde yaptığı şey belirsizliği ortadan kaldırmaktır: Tutarlı ad, logo ve sameAs profilleri içeren Organization işaretlemesi bir sitenin hangi varlığa ait olduğunu belirtir; Product veya SoftwareApplication işaretlemesi ise ne sattığınızı ve hangi fiyata sattığınızı belirtir. Bu, sayfayı okuyan her sistem için yararlıdır; kimlik işaretlemesi kontrolünün AI arama hazırlık denetleyicimizin bir parçası olmasının nedeni de budur. Bunu bir kaldıraç olarak değil, hijyen olarak görün. Yapay zeka yanıtları için asıl kaldıraçlar, örneğin tarayıcı erişimi ve üçüncü taraf bahisleri, generative engine optimization rehberimizde, sonucun ölçülmesi ise AI görünürlük takibi yazısında ele alınıyor.

Yapılandırılmış veri nasıl test edilir

Üç farklı soru için üç araç kullanın.

1. Rich Results Test: "Bu, bir Google zengin sonucu için uygun mu?" Bulduğu zengin sonuç türlerini hatalar ve uyarılarla birlikte gösterir ve varsayılan olarak akıllı telefon olarak test eder. İşaretlemeniz JavaScript ile üretiliyorsa yapıştırılmış kod yerine URL girişini kullanın; Google'ın JavaScript rehberi, Google'ın render edilmiş DOM'da bulunan yapılandırılmış veriyi işlediğini, ancak kod girişinin sınırlamaları olduğunu söyler.
2. Schema Markup Validator: "Bu geçerli bir schema.org mu?" Google, eski Structured Data Testing Tool'unu 2021'de Google'a özgü kontroller içermeyen genel bir doğrulayıcı olarak schema.org'a taşıdı. Google'ın zengin sonuç olarak göstermediği türler için, örneğin logonun ötesindeki Organization ayrıntıları için kullanın.
3. Search Console zengin sonuç raporları: "Tüm sitede çalışıyor mu?" Google işaretleme bulduğunda desteklenen türler için raporlar görünür. Geçerli öğeler zengin sonuç olarak gösterilebilir; kritik sorunu olan öğeler düzeltilene kadar gösterilemez. Düzeltmeden sonra, Google'ın etkilenen sayfaları yeniden kontrol etmesi için Düzeltmeyi doğrula'yı kullanın.

JavaScript konusunda bir uyarı: Google, dinamik olarak üretilen Product işaretlemesinin Shopping taramalarını daha seyrek ve daha az güvenilir hale getirebileceğini belirtir; bu, hızlı değişen fiyatlar ve stok için önemlidir. Mümkünse ürün işaretlemesini sunucu tarafında oluşturulan HTML'e koyun.

Yaygın hatalar

Uygulamalı örnek: bir mağazanın ürün sayfasını düzeltmek (varsayımsal)

Aşağıdaki örnek varsayımsaldır, gerçek veri değildir. Popüler bir e-ticaret platformunda kurulu, uydurma bir çevrimiçi mağaza olan Copperleaf Ceramics, ürün sayfalarının düz mavi bağlantılar olarak göründüğünü, rakiplerin ise sonuçlarda fiyat ve stok gösterdiğini fark eder. Kupa sayfasının denetimi şunları ortaya çıkarır:

Düzeltmeler bir öğleden sonra sürdü:

1. Temanın ürün işaretlemesi kapatıldı ve yorum uygulaması, puanını canlı yorum verisini kullanarak tek bir Product bloğuna ekleyecek şekilde yapılandırıldı.
2. Teklif yeniden yazıldı: "price": "32.00", "priceCurrency": "USD", availability ve itemCondition eklendi, kampanyalar sırasında indirim dönemi validFrom ve priceValidUntil ile ayarlandı.
3. Üç görsel oranı eklendi.
4. Ana sayfaya logo ve sameAs içeren Organization işaretlemesi eklendi; ürün sayfalarından @id ile atıf yapıldı.
5. SSS bölümü görünür bırakıldı, çünkü müşteriler onu okuyor; ancak işaretlemesi bir arama özelliği olarak görülmeyi bıraktı.
6. Beş ürün URL'sinde Rich Results Test çalıştırıldı, ardından sonraki haftalarda Search Console merchant listing raporu izlendi: Google sayfaları yeniden taradıkça geçersiz öğeler sıfıra düştü.

Mağaza zengin sonucun görünmesini zorlayamaz, ama artık her sayfa uygun durumda ve hiçbir şey alışveriş yapanların gördüğüyle çelişmiyor.

Yaygın platformlarda schema uygulaması

• WordPress. Yoast SEO ve Rank Math, site temsili ayarlarını doldurduğunuzda Organization veya Person, WebSite, WebPage, Article ve BreadcrumbList çıktısı verir. WooCommerce Product işaretlemesi ekler. Bir tema veya başka bir eklenti kendi işaretlemesini eklediğinde yinelenenleri kontrol edin.
• Shopify. Temalar genellikle ürün işaretlemesi üretir; bu çoğunlukla bir ürünü schema.org Product'a (varyantı varsa ProductGroup'a) ve bir makaleyi Article'a dönüştüren Liquid structured_data filtresi ile olur. Yorum uygulamaları ikinci bir blok ekleyebilir; sayfa kaynağını kontrol edin.
• Özel siteler ve framework'ler. JSON-LD'yi, sayfayı oluşturan aynı veriden sunucuda üretin; böylece fiyat ve stok asla birbiriyle çelişmez.
• Schema markup generator'ları. Organization gibi tek seferlik bloklar için uygundur. Fiyat, puan veya tarih içeren işaretlemelerde statik çıktı eskir; bunları kendi verinizden üretin.

30 dakikalık schema kontrol listesi

1. Ücretsiz schema markup checker aracını ana sayfanızda ve önemli sayfalarınızda çalıştırın; her birinin hangi JSON-LD türlerini bildirdiğini ve sameAs içeren Organization veya LocalBusiness kimlik işaretlemesine sahip olup olmadığını görün.
2. Her şablon için bir sayfada Rich Results Test çalıştırın: ana sayfa, ürün veya hizmet, makale, lokasyon.
3. Bulunan her türü desteklenen, kaldırılmış veya zengin sonuç türü olmayan olarak işaretleyin ve yinelenenleri kaldırın.
4. Tuttuğunuz türlerin zorunlu özelliklerini doldurun.
5. İşaretlenen her değeri görünen sayfayla karşılaştırın: fiyat, puan, çalışma saatleri, tarihler.
6. Sosyal paylaşım etiketlerini de kontrol edin; aynı şablon değişiklikleri sıklıkla onları da bozar.
7. İki ila dört hafta sonra Search Console'da yeniden kontrol edin.

Searvia yapılandırılmış verinizi nasıl kontrol eder

Ücretsiz schema markup checker, website SEO checker aracımızla aynı altyapıyı kullanır: girdiğiniz sayfanın HTML'indeki JSON-LD'yi okur (yalnızca alan adı girerseniz ana sayfanızı), bulduğu türleri listeler, Organization, LocalBusiness veya Person kimlik işaretlemesini ve sameAs bağlantılarını kontrol eder, soru-cevap içeriğini arar; bunların hepsi 38 kontrolün geri kalanıyla birlikte yapılır. Uygulamada site audit sayfalarınızı her hafta tarar, her birindeki schema türlerini kaydeder ve yapılandırılmış verisi olmayan bir ana sayfayı; başlıklar, bozuk sayfalar ve sitemap sorunlarıyla birlikte işaretler. Neyin hangi sırayla kontrol edileceğine dair daha geniş resim için teknik SEO denetimi rehberimize bakın.