14 Tem 2026

"item" Alanı Eksik ("itemListElement" İçinde) Hatası ve Çözümü

Google Search Console'da sitenizi tarattığınızda veya zengin sonuçlar test aracını kullandığınızda karşınıza çıkan teknik hatalar can sıkıcı olabilir. Bunlardan biri de özellikle breadcrumb (içerik haritası) yapılandırmasında sıkça görülen "item" alanı eksik ("itemListElement" içinde)" hatasıdır.

"item" Alanı Eksik ("itemListElement" İçinde) Hatası ve Çözümü


Bu rehberde, bu hatanın ne anlama geldiğini, neden ortaya çıktığını, Blogger başta olmak üzere tüm platformlarda nasıl çözüleceğini ve SEO açısından neden kritik olduğunu anlatacağım. Korkmayın, çözümü sandığınızdan çok daha basit.

Breadcrumb (İçerik Haritası) Nedir?

Hatanın detaylarına girmeden önce, breadcrumb'ın ne olduğunu kısaca hatırlayalım. Breadcrumb, bir web sitesinde kullanıcının bulunduğu sayfanın hiyerarşik konumunu gösteren gezinme zinciridir. Genellikle sayfanın üst kısmında şu şekilde görünür:

Anasayfa > Kategori > Alt Kategori > Mevcut Sayfa

Bu yapı, hem kullanıcıların sitede kaybolmadan gezinmesini sağlar hem de arama motorlarının site yapısını daha iyi anlamasına yardımcı olur. Google, breadcrumb verilerini okuyarak arama sonuçlarında sitenizin bağlantılarını daha zengin ve tıklanabilir bir formatta gösterebilir.

"item" Alanı Eksik Hatası Tam Olarak Nedir?

Bu hata, sayfanızın kaynak kodunda bulunan Schema.org tabanlı BreadcrumbList yapılandırmasında, itemListElement dizisi içindeki bir veya daha fazla öğenin item özelliğinin eksik olduğunu belirtir.

Google'ın beklentisi şudur: Her bir breadcrumb adımı (anasayfa, kategori sayfası, mevcut sayfa gibi) üç temel özelliği içermelidir:

@type: Öğenin türü (genellikle "ListItem")
position: Öğenin sıralamadaki yeri (1, 2, 3...)
item: Öğenin adı ve bağlantısı

İşte tam da burada "item" alanı boş bırakıldığında veya hiç tanımlanmadığında Google bu hatayı verir. Teknik olarak ifade etmek gerekirse, "itemListElement" bir dizi (array) yapısıdır ve bu dizinin her bir elemanı bir "ListItem" olmak zorundadır. Her "ListItem" ise mutlaka bir item nesnesi içermelidir.

Hatanın Yaygın Nedenleri

Bu sorunun arkasında yatan başlıca sebepler şunlardır:

1. Eksik JSON-LD Kodu
Breadcrumb şeması sayfanıza hiç eklenmemiş olabilir ya da eksik eklenmiştir. Özellikle manuel olarak tema düzenlemesi yapan Blogger kullanıcılarında sık görülür.

2. Dinamik Etiketlerin Boş Dönmesi
Blogger'da kullanılan expr:data:label.name gibi dinamik etiketler, etiket sayfası dışındaki sayfalarda boş değer döndürebilir. Bu da item alanının içinin boş kalmasına neden olur.

3. Anasayfa veya Statik Sayfalarda Kategori Bilgisi Olmaması
Breadcrumb yapısı her sayfa tipine uygun şekilde uyarlanmamışsa, anasayfa veya hakkında gibi statik sayfalarda kategori adımı boş kalır ve hata tetiklenir.

4. Yanlış Sıralama (Position) Numarası
Position değeri 1'den başlamazsa veya atlamalı giderse Google şemayı doğrulamakta zorlanabilir. Position daima 1'den başlamalı ve sıralı ilerlemelidir.

5. Eksik veya Hatalı URL
item içindeki @id veya url alanı boş bırakılmış olabilir ya da geçersiz bir URL formatı içeriyor olabilir. Özellikle anasayfa bağlantısı için "data:blog.homepageUrl" etiketi kullanılmıyorsa bu sorun ortaya çıkar.

Blogger İçin Kesin Çözüm (Adım Adım)

Blogger kullanıcıları için bu hatayı kalıcı olarak çözecek eksiksiz bir JSON-LD breadcrumb şeması hazırladım. Bu kod, sayfa tipine göre dinamik olarak uyarlanır ve hiçbir item alanını boş bırakmaz.

Adım 1: Blogger Temanızı Yedekleyin
  • Herhangi bir kod değişikliğinden önce mutlaka yedek alın.
  • Blogger kontrol panelinde Tema bölümüne gidin.
  • Sağ üst köşedeki Yedekle/Geri Yükle butonuna tıklayın.
  • Temayı İndir seçeneğiyle mevcut temanızı bilgisayarınıza kaydedin.
Adım 2: HTML Düzenleyiciyi Açın
  • Tema bölümünde HTML'yi Düzenle butonuna tıklayın.
  • Kod editörünün içine tıklayın ve </head> etiketini bulmak için Ctrl + F ile arama yapın.
Adım 3: Breadcrumb Şema Kodunu Ekleyin

Aşağıdaki JSON-LD kodunu </head> etiketinin hemen üstüne yapıştırın. Bu kod, tüm sayfa türlerini (anasayfa, yazı sayfası, statik sayfa, etiket sayfası, arşiv sayfası) algılayarak uygun breadcrumb yapısını oluşturur.

<!-- BreadcrumbList Structured Data -->
<b:if cond='data:blog.pageType != &quot;error_page&quot;'>
<script type='application/ld+json'>
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@id": "<data:blog.homepageUrl/>",
        "name": "Anasayfa"
      }
    }
    <b:if cond='data:blog.pageType == &quot;item&quot;'>
    <b:if cond='data:post.labels'>
    <b:loop values='data:post.labels' var='label' index='i'>
    <b:if cond='data:i == 0'>
    ,{
      "@type": "ListItem",
      "position": 2,
      "item": {
        "@id": "<data:label.url/>",
        "name": "<data:label.name/>"
      }
    }
    </b:if>
    </b:loop>
    </b:if>
    ,{
      "@type": "ListItem",
      "position": <b:if cond='data:post.labels'>3<b:else/>2</b:if>,
      "item": {
        "@id": "<data:post.url/>",
        "name": "<data:post.title/>"
      }
    }
    </b:if>
    <b:if cond='data:blog.pageType == &quot;static_page&quot;'>
    ,{
      "@type": "ListItem",
      "position": 2,
      "item": {
        "@id": "<data:blog.url/>",
        "name": "<data:blog.pageName/>"
      }
    }
    </b:if>
    <b:if cond='data:blog.pageType == &quot;archive&quot;'>
    ,{
      "@type": "ListItem",
      "position": 2,
      "item": {
        "@id": "<data:blog.url/>",
        "name": "Arşiv"
      }
    }
    </b:if>
  ]
}
</script>
</b:if>

Adım 4: Temayı Kaydedin

  • Kodu yapıştırdıktan sonra sağ üstteki Kaydet (disket simgesi) butonuna tıklayarak temayı kaydedin.

Adım 5: Google Rich Results Test ile Doğrulayın

  • Google'da Rich Results Test araması yapın veya doğrudan https://search.google.com/test/rich-results adresine gidin.
  • Sitenizin herhangi bir blog yazısının URL'sini girin.
  • Test Et butonuna tıklayın.
  • "Breadcrumb" bölümünde yeşil onay işareti ve "Geçerli öğe" yazısını görmelisiniz.
  • Anasayfa, statik sayfa ve etiket sayfası gibi farklı sayfa türlerini de ayrı ayrı test edin.

Diğer Platformlar İçin Çözüm (WordPress, Özel HTML)

Eğer Blogger değil de WordPress veya özel bir HTML sitesi kullanıyorsanız, sorunu çözmek için şu noktalara dikkat edin:

WordPress Kullanıcıları İçin

Çoğu SEO eklentisi (Yoast SEO, Rank Math, SEOPress) breadcrumb şemasını otomatik oluşturur. Hata alıyorsanız:

  • Eklentinin güncel olduğundan emin olun.
  • Eklentinin breadcrumb ayarlarında "Breadcrumb'ları etkinleştir" seçeneğinin açık olduğunu kontrol edin.
  • Tema dosyanızda
<?php if (function_exists('yoast_breadcrumb')) { yoast_breadcrumb('<p id="breadcrumbs">','</p>'); } ?>

kodunun header.php veya single.php içinde yer aldığını doğrulayın.

Özel HTML Siteleri İçin

Manuel olarak JSON-LD breadcrumb eklerken şu yapıyı referans alın ve her item alanının dolu olduğundan emin olun:

<script type="application/ld+json">

{

  "@context": "https://schema.org",

  "@type": "BreadcrumbList",

  "itemListElement": [

    {

      "@type": "ListItem",

      "position": 1,

      "item": {

        "@id": "https://www.siteniz.com/",

        "name": "Anasayfa"

      }

    },

    {

      "@type": "ListItem",

      "position": 2,

      "item": {

        "@id": "https://www.siteniz.com/kategori/",

        "name": "Kategori Adı"

      }

    },

    {

      "@type": "ListItem",

      "position": 3,

      "item": {

        "@id": "https://www.siteniz.com/kategori/yazi/",

        "name": "Yazı Başlığı"

      }

    }

  ]

}

</script>

Burada kritik nokta, her "ListItem" içinde mutlaka bir "item" nesnesi olması ve bu nesnenin de "@id" ve "name" özelliklerini eksiksiz içermesidir.

Sıkça Sorulan Sorular

Bu hatayı görmezden gelsem ne olur?

Google, breadcrumb verilerinizi okuyamaz ve arama sonuçlarında sitenizin bağlantısı zengin breadcrumb görünümünde değil, standart URL formatında görünür. Bu da tıklanma oranınızı (CTR) düşürebilir.

Kodu ekledim ama hata devam ediyor, ne yapmalıyım?

Google Search Console'da "Düzeltmeyi Doğrula" butonuna basın. Google'ın sitenizi yeniden taraması birkaç gün sürebilir. Ayrıca farklı sayfa türlerini (anasayfa, yazı, statik sayfa) Rich Results Test ile ayrı ayrı kontrol edin.

Her sayfada breadcrumb göstermek zorunda mıyım?

Evet, Google'ın breadcrumb şemasını tüm sayfalarınızda tutarlı bir şekilde uygulamanız beklenir. Anasayfa dahil tüm sayfalar breadcrumb içermelidir.

Birden fazla etiketim var, hangisi breadcrumb'da görünecek?

Yukarıdaki Blogger kodu, yazınıza atadığınız ilk etiketi (alfabetik olarak değil, atama sıranıza göre) breadcrumb'da gösterir. Bu, SEO açısından yeterli ve temiz bir yaklaşımdır.

Paylaş:

0 comments:

Yorum Gönder