Schema markup, yani yapısal veri işaretlemesi, web sitenizin içeriğini arama motorlarına daha anlaşılır hale getiren güçlü bir araçtır. Google, Bing ve diğer motorlar, bu işaretlemeleri kullanarak zengin sonuçlar (rich snippets) oluşturur: yıldızlı yorumlar, FAQ accordion’ları, ürün fiyatları gibi özellikler. Ancak yanlış uygulama, bu fırsatları kaçırmanıza ve hatta manuel cezalar almanıza neden olabilir.
Magmaroot Web Tasarım Ajansı olarak, 10+ yıldır yüzlerce kurumsal sitede schema implementation’ı yönetiyoruz. 2026’da AI destekli arama (AI Overviews) ve entity-based ranking’lerin yükselişiyle schema markup daha kritik hale geldi. Bu rehberde, en sık karşılaştığımız hataları, gerçek proje örnekleriyle paylaşacağız.

Schema Markup Nedir ve Neden Hatalar Önemli?
Schema markup, schema.org vocabulary’sini kullanarak JSON-LD, Microdata veya RDFa formatlarında eklenen kodlardır. Google’ın tercihi JSON-LD’dir çünkü bakımını kolaylaştırır ve performans etkilemez.
Hatalar şu sorunlara yol açar:
- Zengin sonuçların görünmemesi
- Google Search Console’da uyarı/hata raporları
- Yanlış yorumlama sonucu ranking düşüşü
- Manuel işlem riski (spammy markup)
2026 trendlerinde, schema hataları AI citation’larını da etkileyecek. Doğru markup, sitenizin Knowledge Graph’e entegre olmasını sağlar.
En Yaygın Schema Markup Hataları
Yıllık audit’lerimizde karşılaştığımız hataları kategorilere ayırdık.
1. Syntax ve Format Hataları
JSON-LD’de en küçük hata (eksik virgül, yanlış tırnak) tüm markup’ı geçersiz kılar.
Örnek Hata Kodu:
{
"@context": "https://schema.org",
"@type": "Product"
"name": "Örnek Ürün" // Eksik virgül
}
Çözüm: Her zaman validator kullanın. Google Rich Results Test ve Schema.org Validator ile test edin.
2. Missing Required Fields (Zorunlu Alanlar Eksik)
Her schema tipinin zorunlu property’leri vardır. Örneğin Product için “name” ve “offers” zorunlu.
Karşılaştırma Tablosu: Yaygın Schema Tipleri ve Zorunlu Alanları
| Schema Tipi | Zorunlu Alanlar | Sık Hata Örneği |
|---|---|---|
| Product | name, offers | Offers eksik |
| Article | headline, author, datePublished | Author eksik |
| Organization | name, logo | Logo URL hatalı |
| FAQPage | mainEntity (question/name, answer/acceptedAnswer) | Question eksik |
| LocalBusiness | name, address, telephone | Address incomplete |
Magmaroot projelerinde, e-ticaret sitelerinde Product schema’da offers eksikliği sık görülür. Sonuç: Ürün carousel’leri görünmez.
3. Invalid Values (Geçersiz Değerler)
Tarih formatı ISO 8601 olmayan (örneğin “15/10/2025” yerine “2025-10-15”), fiyat string yerine number olmayan.
Doğru Örnek:
"price": 999.99,
"priceCurrency": "TRY",
"datePublished": "2026-01-04"
Çözüm: Schema.org dokümantasyonunu takip edin.
4. Yanlış Schema Tipi Kullanımı
Blog yazısına NewsArticle yerine BlogPosting kullanmak, veya kategori sayfasına Product markup eklemek.
Gerçek örnek: Bir müşterimizin WooCommerce sitesinde kategori sayfalarına Product schema otomatik ekleniyordu. Sonuç: GSC’de yüzlerce hata.
Çözüm: Sayfa tipine uygun schema seçin. Bkz. Schema Markup Ekleme Rehberi
5. İçerikle Uyumsuz Markup (Markup Mismatch)
Görünmeyen içeriğe schema eklemek (hidden text) veya gerçek olmayan review’lar.
Google’ın spammy markup politikası: Bu, manuel ceza getirir.
6. Duplicate veya Çakışan Markup
Aynı sayfada birden fazla aynı tip schema, veya plugin’ler arası çakışma (Yoast + Rank Math).
Numaralı Liste: Hata Kontrol Adımları
- Google Search Console > Enhancements > Structured Data raporlarını inceleyin.
- Rich Results Test ile tek sayfa testi yapın.
- Schema Markup Validator ile genel doğrulama.
- Log analiziyle tarama hatalarını kontrol edin. Log Analizi ile SEO
- Düzenleme sonrası yeniden indeksleme isteyin.
7. Deprecated Types ve Güncel Olmama
2026’da Google bazı tipleri deprecated etti (örneğin Dataset, Sitelinks Search Box). Eski tipler hata verir.
Çözüm: Schema.org’u düzenli takip edin.
8. JavaScript Render Sorunları
JS ile yüklenen markup’ı Google bazen okumaz.
Çözüm: JSON-LD’yi head’e statik ekleyin.
Schema Hatalarını Önleme Best Practices (2026 İçin)
Magmaroot olarak önerilerimiz:
- JSON-LD tercih edin.
- Otomatik generator’lar kullanın ama manuel kontrol edin.
- Site-wide Organization, site haritası ile entegre edin (bkz. Site Haritası ve Robots.txt Nasıl Hazırlanır?).
- Aylık audit yapın.
- Plugin’lerde (Yoast, Rank Math) çakışma önleyin.
Gerçek proje: Bir kurumsal müşterimizde FAQ schema hatalarını düzelterek CTR %25 artırdık.
Daha fazla için bkz:
- Teknik SEO Nedir? Başlangıç Rehberi
- Schema Markup Ekleme Rehberi
- Lighthouse Testi Nasıl Yapılır?
- On-Page SEO Nedir? Kapsamlı Rehber
- Görsel SEO Rehberi
- Core Web Vitals Nasıl İyileştirilir?
- WordPress SEO Ayarları: Eksiksiz Liste
- Topic Cluster Modeli Ne İşe Yarar?
- Arama Niyeti Analizi (Search Intent)
- SERP Analizi Nasıl Yapılır?
- Google’ın EEAT Kılavuzu Nasıl Uygulanır?
- Doğal Backlink Nasıl Alınır?
- 2025 Web Tasarım Trendleri
- WordPress Hız Optimizasyonu Rehberi
- Dönüşüm Odaklı Tasarım (CRO) Nedir?
Bu adımlarla schema’nızı hatasız hale getirin!
Sık Sorulan Sorular
Schema markup hataları, yapısal veri kodlarında syntax, missing fields veya invalid values gibi sorunlardır. Bunlar zengin sonuçların görünmemesine neden olur.
Missing required fields ve syntax hataları en yaygındır. Örneğin Product schema’da offers eksikliği.
Google Rich Results Test ve Schema Validator kullanarak test edin, hataları düzeltip yeniden indeksleyin.
Google manuel ceza uygulayabilir, zengin sonuçlar kaldırılır.
Evet, AI Overviews ve entity-based search için daha kritik hale geldi.
Google JSON-LD’yi önerir, bakım ve performans açısından üstün.
Doğrudan değil ama zengin sonuç kaybı CTR’yi düşürür, dolaylı etki yaratır.
Tek plugin kullanın (Yoast veya Rank Math) ve çakışmaları kontrol edin.