Ücretsiz Schema / JSON-LD Oluşturucu

1. Hangi sayfa için kod oluşturacaksınız?

Hazır kodunuz

Önce sayfa türünü seçin.

Schema / JSON-LD Oluşturucu, seçtiğiniz Schema.org türü için girdiğiniz bilgileri geçerli JSON-LD yapılandırılmış veri koduna dönüştüren ücretsiz bir araçtır. Article, Product, LocalBusiness, Organization veya BreadcrumbList türünü seçin ve sayfanızda gerçekten yer alan bilgileri girin. Oluşan kodu kontrol edip kopyaladıktan sonra ilgili sayfanıza ekleyebilirsiniz. Kodun geçerli olması, Google'ın sayfanızı zengin sonuçla göstereceğini garanti etmez.

Schema Türünü Seçin ve JSON-LD Kodunuzu Oluşturun

JSON-LD kodu oluşturmak için sayfanızın ana varlığına uygun Schema türünü seçin ve açılan forma yalnızca sayfada görünen bilgileri girin. Yukarıdaki araç bu bilgileri Schema.org yapısına uygun bir JSON-LD nesnesine dönüştürür, kodu her zaman geçerli JSON olarak üretir ve altındaki kontrol listesinde eksik ya da hatalı alanları gösterir. Kodu sitenize eklemek ve canlı sayfada test etmek ise sizin tamamlamanız gereken adımlardır.

  • Makale / Blog yazısı (Article) Makalenizin başlığı, yazarı, yayın tarihi ve görseli için yapılandırılmış veri oluşturun.
  • Ürün (Product) Ürününüzün adı, açıklaması ve geçerli teklif bilgileri için JSON-LD hazırlayın.
  • Yerel işletme (LocalBusiness) İşletmenizin adını, adresini, iletişim bilgilerini ve çalışma saatlerini yapılandırın.
  • Kurum (Organization) Şirketinizin adını, web adresini, logosunu ve resmî profil bağlantılarını tanımlayın.
  • Sayfa yolu (BreadcrumbList) Web sitenizin gezinme hiyerarşisini JSON-LD biçiminde oluşturun.

Form, seçtiğiniz türe göre değişir. Temel alanlar ilk sırada görünür, yıldızlı alanlar zorunludur ve isteğe bağlı alanlar Diğer alanlar bölümünde yer alır. Boş bıraktığınız alanlar çıktıya eklenmez. Böylece kodda "telephone": "" gibi anlamsız değerler oluşmaz. Kod siz yazdıkça anında güncellenir. Tür değiştirdiğinizde form yeni türe göre baştan oluşturulur ve girdiğiniz bilgiler silinir.

Önemli nokta

Araç oluşturduğu kodu sitenize otomatik olarak eklemez, Google Search Console hesabınıza bağlanmaz ve Google'a dizine ekleme isteği göndermez. URL alanlarında yalnızca biçim kontrolü yapılır. Adreslerin gerçekten açıldığını canlı sayfada ayrıca doğrulayın.

Schema Markup Nedir?

Schema Markup, bir web sayfasındaki varlıkları ve bu varlıkların özelliklerini Schema.org sözlüğündeki türler ve property'ler aracılığıyla makinelerin okuyabileceği biçimde tanımlayan işaretlemedir. Örneğin bir ürün sayfasında ürünün adı, fiyatı ve stok durumu ayrı alanlar olarak belirtilir. Arama motorları bu yapılandırılmış bilgileri sayfanın içeriğini anlamak için kullanabilir.

Schema.org, arama motorlarının ve diğer uygulamaların ortak kullandığı bir sözlüktür. Bu sözlükte Article, Product ve Organization gibi türler ile her türün alabileceği name, price veya address gibi özellikler tanımlanır. Tür, sayfanın neyi anlattığını belirtir. Property ise o varlığın hangi niteliğinin hangi değeri taşıdığını gösterir.

Bu ilişkiyi tür, özellik ve değer zinciri olarak düşünebilirsiniz. Product türündeki bir varlıkta name özelliği ürün adını, offers özelliği ise satış teklifini taşır. Offer nesnesindeki price özelliği de teklifin fiyatını verir. Farklı türlere ait özellikleri yalnızca adları benzediği için aynı nesnede birleştirmek varlığı yanlış tanımlar.

Google'ın yapılandırılmış veri belgesi, sayfadaki yapılandırılmış verilerin içeriği anlamaya ve bazı arama sonuçlarını zenginleştirmeye yardımcı olabileceğini açıklar. Schema türleri ve yapılandırılmış verilerin SEO açısından kullanımını öğrenmek için yapılandırılmış veri rehberini inceleyebilirsiniz. Yapılandırılmış verilerin GEO uygulamalarındaki rolünü ise GEO için yapılandırılmış veri sayfasında ayrıca ele alıyoruz.

JSON-LD Nedir ve Ne İşe Yarar?

JSON-LD, bağlantılı verileri JSON biçiminde ifade etmeye yarayan ve W3C tarafından standartlaştırılan bir veri formatıdır. Web sayfalarında Schema.org yapılandırılmış verilerini görünür HTML'den ayrı bir script bloğu içinde tanımlamak için kullanılır. Google, sitenizin altyapısı izin veriyorsa yapılandırılmış veriler için genel olarak JSON-LD kullanmanızı önerir.

JSON-LD 1.1, 16 Temmuz 2020 tarihinde W3C önerisi olarak yayımlanmıştır. Araçtan çıkan kodu okuyabilmek için birkaç temel anahtarı bilmeniz yeterlidir.

  • @context kodun hangi sözlüğü kullandığını gösterir. Schema.org için değeri https://schema.org olur.
  • @type tanımlanan varlığın türünü belirtir. Örneğin Organization veya Product.
  • @id varlığa kalıcı bir kimlik verir. Aynı varlığı farklı bloklarda tutarlı biçimde tanımlamak için kullanılır.
  • Diğer anahtarlar o türün property'leridir ve her biri bir değer taşır. Değer metin, sayı, dizi veya iç içe başka bir nesne olabilir.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Örnek Şirket",
  "url": "https://ornek.com/"
}
</script>

Bu örnek geçerli bir temel JSON-LD nesnesidir. Kodun geçerli olması herhangi bir Google arama özelliğinin koşullarını karşıladığını göstermez. Araç çıktıyı sayfaya eklemeye hazır script etiketiyle birlikte verir.

Schema.org ile JSON-LD aynı şey mi?

Hayır. Schema.org varlıkları ve özellikleri tanımlayan bir sözlüktür. JSON-LD ise bu sözlükteki bilgileri ifade edebileceğiniz formatlardan biridir.

Google aynı Schema.org verisini JSON-LD, Microdata ve RDFa formatlarında okuyabilir. JSON-LD verisi görünür HTML öğelerinin içine yazılmadığı için şablondan bağımsız olarak eklenebilir ve güncellenebilir. Bu araç yalnızca JSON-LD üretir.

Hangi Schema Türünü Kullanmalısınız?

Schema türünü sayfanın gerçekten temsil ettiği ana varlığa göre seçmelisiniz. Makaleler için Article veya BlogPosting, ürün sayfaları için Product, fiziksel işletmeler için LocalBusiness ya da uygun bir alt tür, kurumsal kimlik için Organization ve gezinme yolu için BreadcrumbList kullanılır. Bir sayfada birden fazla uygun tür bulunabilir. Yine de her türü her sayfaya eklemek doğru bir uygulama sayılmaz.

Aşağıdaki tablo, her tür için Google'ın ilgili arama özelliğini ve bu özellik için zorunlu tuttuğu alanları Google Search Central belgelerine göre özetler.

Sayfa türüne göre Schema seçimi ve Google'ın zorunlu alanları
Sayfa veya varlık Schema türü İlgili Google özelliği Google'ın zorunlu alanları
Blog yazısı veya makaleArticle, BlogPostingMakaleZorunlu alan yok, önerilen alanlar var
Haber içeriğiNewsArticleMakaleZorunlu alan yok, önerilen alanlar var
Satın alma yapılmayan ürün sayfasıProductÜrün snippet'iname ile review, aggregateRating veya offers alanlarından biri
Satış yapılan ürün sayfasıProduct ve OfferSatıcı listelemesiname, image, offers, price ve priceCurrency
Fiziksel işletmeLocalBusiness veya alt türYerel işletmename ve address
Kurumsal kimlikOrganizationKuruluşZorunlu alan yok, önerilen alanlar var
Sayfa gezinme yoluBreadcrumbListSayfa yoluEn az iki ListItem ile her öğede name, item ve position

Tablodaki zorunlu alanlar Article, ürün snippet'i, satıcı listelemesi, yerel işletme, kuruluş ve sayfa yolu belgelerinden alınmıştır. Article ve Organization için Google'ın zorunlu alanı yoktur. Bu nedenle formdaki yıldızlı alanlar aracın anlamlı bir kod üretmesi için gereken asgari bilgiyi gösterir ve Google'ın bir hata kuralı olarak okunmamalıdır.

Örneğin bir ürün detay sayfasında Product ve BreadcrumbList birlikte yer alabilir. Araç ilk sürümde her tür için ayrı bir JSON-LD bloğu oluşturur. Aynı sayfaya birden fazla blok eklediğinizde her bloğun farklı bir varlığı tanımladığından emin olun.

Uyarı

Schema.org'da bir türün bulunması, Google'ın o tür için özel bir arama görünümü sunduğu anlamına gelmez. Google'ın hangi özellikleri desteklediğini arama galerisinden kontrol edin. Kaldırılan bir özellik için kod eklemek o görünümü geri getirmez.

Article Schema Nasıl Oluşturulur?

Article Schema oluşturmak için araçta Makale / Blog yazısı türünü seçin, Yazı türü listesinden alt türü belirleyin ve sayfada gerçekten yer alan başlık, yazar, yayın tarihi ve görsel bilgilerini girin. Google'ın Article belgesinde zorunlu property bulunmaz. headline, author, datePublished, dateModified ve image ise önerilen alanlar arasındadır.

Article formundaki alanlar ve JSON-LD karşılıkları
Alan etiketi Property Formdaki durumu
BaşlıkheadlineZorunlu
Sayfa adresimainEntityOfPage.@idTemel alan
Yazar adı ve Yazar sayfasıauthor.name, author.urlYazar adı önerilen, Yazar sayfası Diğer alanlarda
Yayın tarihidatePublishedÖnerilen
Güncelleme tarihidateModifiedDiğer alanlar
Kapak görseli adresiimageÖnerilen
Kısa açıklamadescriptionDiğer alanlar
Yayıncı ve Yayıncı logosu adresipublisher.name, publisher.logoDiğer alanlar

Tablodaki durumlar aracın arayüz tercihidir. Google'ın evrensel bir zorunlu alan listesi yayımladığı anlamına gelmez.

Article, BlogPosting ve NewsArticle arasında nasıl seçim yapılır?

Genel editoryal içerik için Article, blog yazıları için BlogPosting, haber içerikleri için NewsArticle seçin. NewsArticle türünü haber niteliği taşımayan bir makaleye eklemeyin.

Üç tür de Google'ın Article belgesinde aynı önerilen alanlarla desteklenir. Seçim, içeriğin sitenizde gerçekte hangi rolü üstlendiğine bağlıdır. Kişisel bir blog yazısı için BlogPosting, güncel bir olayı aktaran haber metni için NewsArticle daha doğru bir tanım sunar.

Yazar, tarih ve görsel bilgileri nasıl girilir?

Araç yazarı her zaman Person olarak yazar. Yazar adı alanına yalnızca kişinin adını yazın. Tarihleri takvim alanından gün olarak seçersiniz ve araç bunları saat olmadan 2026-10-20 gibi ISO 8601 tarih biçiminde yazar. Yayın tarihini bilmiyorsanız alanı boş bırakın, çünkü araç bugünün tarihini otomatik olarak eklemez.

Google, birden fazla yazarı tek bir alanda birleştirmek yerine her yazar için ayrı bir author girişi kullanmanızı önerir. Araç tek yazar destekler. Birden fazla yazar varsa diğerlerini kopyaladığınız koda elle ekleyin. Unvanlar ad alanına yazılmaz. Yazarın biyografi sayfası varsa Yazar sayfası alanına ekleyebilirsiniz. Araç yazar için sameAs alanı üretmez.

Saat dilimi belirtilmemiş bir tarihte Google, Googlebot'un kullandığı saat dilimini varsayar. Türkiye saatiyle yayımlanan bir yazı için +03:00 eklemek bu belirsizliği ortadan kaldırır. Araç yalnızca tarihi yazdığı için saat ve saat dilimi gerekiyorsa kopyaladığınız kodda tarihi elle 2026-10-20T10:30:00+03:00 biçimine çevirin. Son güncelleme tarihi yalnızca içerikte gerçek bir değişiklik yapıldığında değişmelidir.

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Teknik SEO Nedir?",
  "description": "Teknik SEO hakkında bilgilendirici makale.",
  "datePublished": "2026-10-20",
  "author": {
    "@type": "Person",
    "name": "Örnek Yazar"
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://ornek.com/teknik-seo/"
  }
}

Örnekte yazar ayrı bir Person nesnesi olarak tanımlanmıştır ve kullanıcının girmediği hiçbir alan çıktıya eklenmemiştir. Sayfa adresi alanı mainEntityOfPage içine yazılır. Görsel URL'si eklerseniz araç yalnızca URL biçimini kontrol eder. Google'ın Article belgesi görselin taranabilir, dizine eklenebilir ve makaleyle ilgili olmasını ister. Genişlik ile yüksekliğin çarpımının en az 50.000 piksel olmasını da önerir.

Product Schema Nasıl Oluşturulur?

Product Schema oluşturmak için ürün adını girin ve sayfada gerçek bir satış teklifi varsa fiyatı, para birimini ve stok durumunu Offer nesnesi içinde tanımlayın. Google, ürün snippet'i için name alanının yanında review, aggregateRating veya offers alanlarından birini zorunlu tutar. Satıcı listelemesi için ise ürün görseli, fiyat ve para birimi de gerekir.

Solda Kablosuz Kulaklık adı, 1.499,90 fiyatı, TRY para birimi ve Stokta durumu girilmiş bir ürün formu. Sağda bu girdilerden oluşan JSON-LD kodu, Product kutusunun içinde price, priceCurrency ve availability alanlarını taşıyan ayrı bir Offer kutusu olarak gösteriliyor.
Form girdileri Product nesnesine ve onun içindeki Offer nesnesine ayrı ayrı yerleşir. Diyagramda okunabilirlik için @context satırı gösterilmemiştir ve değerler kurgusaldır.

Product ve Offer neden ayrı nesnelerdir?

Product ürünün kendisini, Offer ise o ürünün belirli bir satış teklifini tanımladığı için iki ayrı nesne olarak kodlanır. Fiyat, para birimi ve stok durumu teklife ait bilgilerdir. Bu yüzden araç bu bilgileri offers özelliğinin içindeki Offer nesnesine yerleştirir.

Aynı ürün farklı fiyat veya stok koşullarıyla satılabilir. Teklif bilgilerini ürün adının yanına düz metin olarak yazmak bu ilişkiyi kaybettirir. Marka, SKU ve GTIN gibi ürünü tanımlayan bilgiler ise Product nesnesinde kalır.

Fiyat ve stok bilgisi nasıl girilmelidir?

Fiyatı forma Türkçe biçimde, örneğin 1.499,90 olarak girebilirsiniz. Araç bu değeri JSON-LD çıktısında 1499.90 biçiminde ondalık noktalı bir değere dönüştürür. Para birimi listesinden TRY, USD veya EUR seçebilirsiniz ve araç bunu ISO 4217 koduyla yazar. Stok durumu listesinde Stokta, Tükendi, Ön sipariş ve Sipariş üzerine seçenekleri vardır. Araç bunları InStock, OutOfStock, PreOrder ve BackOrder değerlerine çevirir.

Google'ın ürün snippet'i belgesi, kesirli tutarlarda ondalık ayırıcı olarak nokta kullanılmasını ister. Para birimiyle birlikte girilen 0 fiyatı ürünün ücretsiz sunulduğunu bildirir. Bu nedenle fiyatı bilmediğiniz bir ürün için alana 0 yazmayın ve sayfada fiyat yoksa fiyat alanını boş bırakın. Her ürünü otomatik olarak stokta kabul etmek de yanlış bir teklif bilgisi üretir. Stok durumu listesi Stokta seçili gelir, bu yüzden ürün stokta değilse bu seçimi değiştirin. Araç teklife ürünün yeni olduğunu bildiren itemCondition değerini de ekler. İkinci el ürünlerde bu değeri kopyaladığınız kodda değiştirin.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Kablosuz Kulaklık",
  "image": [
    "https://ornek.com/gorseller/kablosuz-kulaklik.jpg"
  ],
  "offers": {
    "@type": "Offer",
    "price": "1499.90",
    "priceCurrency": "TRY",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}

Ürün snippet'i ile satıcı listelemesi arasındaki fark nedir?

Ürün snippet'i ürünün doğrudan satın alınamadığı sayfalar için, satıcı listelemesi ise müşterinin ürünü sizden satın alabildiği sayfalar için tasarlanmıştır. İki özelliğin zorunlu alanları farklıdır. Yalnızca Product türünü seçmek her iki özelliğe de uygunluk sağlamaz.

Google ürün özelliklerinin zorunlu alanları
Ölçüt Ürün snippet'i Satıcı listelemesi
Uygun sayfaİnceleme veya bilgi sayfası gibi satın alma yapılmayan ürün sayfalarıÜrünün sizden satın alınabildiği sayfalar
Product zorunlu alanlarıname ile review, aggregateRating veya offers alanlarından biriname, image ve offers
Offer içinde priceoffers kullanılırsa zorunluZorunlu
priceCurrencyÖnerilenZorunlu
availabilityÖnerilenÖnerilen

Bu karşılaştırma Google'ın ürün yapılandırılmış verisine giriş belgesine ve iki özelliğin ayrı belgelerine dayanır. Fiyatı ve puanı bulunmayan bir ürün sayfasında geçerli bir Product nesnesi oluşturabilirsiniz. Böyle bir nesne Google'ın ürün snippet'i için koyduğu zorunlu alan koşulunu karşılamaz. Satıcı listelemesindeki kargo ve iade gibi ayrıntılı alanlar bu aracın ilk sürüm kapsamı dışındadır.

Uyarı

Sayfada gerçek ve doğrulanabilir değerlendirmeler yoksa aggregateRating veya review eklemeyin. Google, yapılandırılmış veri yönergelerinde sahte yorumları yasaklar ve bu tür sorunlar sayfanın zengin sonuç uygunluğunu kaldıran manuel işleme yol açabilir. Araç ürünlere otomatik puan vermez.

LocalBusiness Schema Nasıl Oluşturulur?

LocalBusiness Schema oluşturmak için işletme adını girin ve fiziksel adresi PostalAddress alanlarına ayrı ayrı yazın. Ardından telefon, web adresi, konum ve çalışma saatleri gibi bilgileri ekleyin. Google bu tür için name ve address alanlarını zorunlu tutar. İşletmenize uyan daha özel bir alt tür varsa İşletme türü listesinden genel LocalBusiness yerine onu seçin.

Google, Restaurant veya Dentist gibi mümkün olan en özel alt türün kullanılmasını önerir. Listede Restoran, Diş kliniği, Mağaza, Otel gibi 12 alt tür vardır. İşletmenize uygun bir seçenek yoksa Genel yerel işletme seçeneği geçerli bir başlangıç noktasıdır. Gerçek bir fiziksel işletme bilgisi yoksa bu türü kullanmayın.

Adres, telefon ve konum bilgileri nasıl yapılandırılır?

Adresi tek bir metin alanına yazmak yerine Açık adres, İlçe, İl ve Posta kodu alanlarına ayırarak girin. Telefonu ülke ve alan koduyla, örneğin +90 ile başlayacak biçimde yazın. Enlem ve boylam eklerseniz Google en az beş ondalık basamak kullanılmasını önerir.

Araç bu alanları PostalAddress nesnesinin streetAddress, addressLocality, addressRegion, postalCode ve addressCountry özelliklerine yerleştirir. Formda ülke alanı yoktur. Araç ülke kodunu her zaman TR olarak yazar. Enlem -90 ile 90, boylam -180 ile 180 arasında olmalıdır. Araç bu aralığı denetlemez, bu yüzden koordinatları girmeden önce kontrol edin. Enlem ve boylamı birlikte girmezseniz konum koda eklenmez.

Çalışma saatleri nasıl girilir?

Çalışma saatlerini günleri seçip Açılış ve Kapanış saatlerini girerek oluşturursunuz. İlk satır Pazartesi-Cuma 09:00-18:00 olarak hazır gelir. Farklı saatler için + Saat ekle düğmesiyle yeni satır ekleyin. Araç bu bilgileri OpeningHoursSpecification nesnelerine dönüştürür. Kapalı günler, gece yarısını aşan saatler ve 24 saat açık işletmeler için Google'ın tanımladığı özel kullanımlar geçerlidir.

  • Kapalı bir gün için açılış ve kapanış saatinin ikisi de 00.00 olarak girilir.
  • Gece yarısını aşan bir vardiyada kapanış saati açılış saatinden önce yazılır. Örneğin cumartesi 18.00 açılıp pazar 03.00'te kapanan bir işletme tek bir tanımla gösterilir.
  • 24 saat açık bir gün için açılış 00.00, kapanış 23.59 olarak girilir.
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Örnek Kafe",
  "telephone": "+902160000000",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Örnek Caddesi No 10",
    "addressLocality": "Kadıköy",
    "addressRegion": "İstanbul",
    "addressCountry": "TR"
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "18:00"
    }
  ]
}

Örnekteki işletme, adres ve telefon kurgusaldır. Kendi kodunuzda yalnızca işletmenizin sayfada da gösterilen gerçek bilgilerini kullanın.

Önemli nokta

LocalBusiness Schema oluşturmak Google Business Profile kaydı açmaz ve mevcut bir profili doğrulamaz. Bu iki işlem birbirinden bağımsızdır. Profil bilgilerinizi ve sitenizdeki yapılandırılmış veriyi tutarlı tutmak için ikisini ayrı ayrı güncelleyin.

Organization Schema Nasıl Oluşturulur?

Organization Schema oluşturmak için kuruluşun adını, web adresini, logosunu ve resmî profil bağlantılarını girin. Google bu tür için zorunlu property belirlemez. Kodu ana sayfanıza veya kuruluşu anlatan tek bir sayfaya, örneğin Hakkımızda sayfasına eklemeniz yeterlidir.

Google'ın kuruluş belgesi, yapılandırılmış verinin her sayfada bulunmasının gerekmediğini belirtir. Logo için en az 112x112 piksellik, taranabilir ve beyaz arka planda doğru görünen bir görsel ister. Kuruluşa ait olmayan rastgele bir görseli logo alanına eklemeyin.

sameAs ve @id alanları ne işe yarar?

sameAs alanı kuruluşa ait resmî profilleri, @id alanı ise kuruluşun kalıcı kimliğini tanımlar. sameAs birden fazla bağlantı alabildiği için araç bu alanı bir dizi olarak üretir. @id için https://ornek.com/#organization gibi değişmeyen bir adres kullanılır. Araç @id alanı üretmez. Gerekirse kopyaladığınız koda elle ekleyin.

LinkedIn sayfanız veya resmî sosyal medya hesabınız gibi doğrulanabilir profilleri Sosyal medya hesapları alanına, her satıra bir adres gelecek şekilde ekleyin. Google'ın genel yapılandırılmış veri yönergeleri, ilişkili öğelerin @id ile bağlanmasının Google'ın bu öğeleri birlikte anlamasına yardımcı olduğunu açıklar. Aynı kuruluşu farklı sayfalarda aynı @id ile tanımlamak bu nedenle tutarlılık sağlar. Varlıkların arama bağlamında tutarlı tanımlanmasını Entity SEO rehberinde ayrıntılı olarak inceleyebilirsiniz.

Organization ile LocalBusiness arasındaki fark nedir?

Organization bir kuruluşun genel kimliğini, LocalBusiness ise müşterilerin ziyaret edebildiği fiziksel bir konumu ve o konumun işletme özelliklerini tanımlar. LocalBusiness, Schema.org'da Organization türünün bir alt türüdür. Bu yüzden her yerel işletme bir kuruluştur, fakat her kuruluş yerel işletme sayılmaz.

Fiziksel mağazası olmayan bir yazılım şirketi için Organization yeterlidir. Kişisel bir portföy sitesinin de Organization türünü kullanması gerekmez. Birden fazla şubesi olan bir marka ise genel kimliğini Organization ile, her şubesini ayrı bir LocalBusiness ile tanımlayabilir.

BreadcrumbList Schema oluşturmak için sayfanın site içindeki gezinme yolunu sırayla girin. Araç her öğeyi ad, URL ve 1'den başlayan position değeri taşıyan bir ListItem nesnesine dönüştürür. Google bu özellik için en az iki ListItem bekler ve son öğenin URL'sini isteğe bağlı tutar.

Formda + Adım ekle düğmesiyle yeni adım ekleyebilir, × düğmesiyle adım silebilirsiniz. Adımları yeniden sıralayan bir düğme yoktur. Sırayı değiştirmek için adları ve adresleri ilgili satırlara yeniden yazın. Bir adımı sildiğinizde position değerleri otomatik olarak yeniden numaralanır. Son öğenin URL'sini boş bırakırsanız Google işaretlemeyi içeren sayfanın URL'sini kullanır.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Ana Sayfa",
      "item": "https://ornek.com/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "SEO",
      "item": "https://ornek.com/seo/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Teknik SEO",
      "item": "https://ornek.com/seo/teknik-seo/"
    }
  ]
}

Google, sayfa yolunun URL yapısını kopyalamak yerine kullanıcının sayfaya ulaşırken izlediği tipik yolu yansıtmasını önerir. Yolu yalnızca anahtar kelime içeren yapay adlarla doldurmayın ve sayfada görünen gezinme yoluyla tutarlı tutun. Google'ın belgesine göre sayfa yolu görünümü masaüstü arama sonuçlarında sunulur. BreadcrumbList, sitenizin URL'lerini arama motorlarına listeleyen bir XML sitemap'in yerini tutmaz. Site haritası için XML Sitemap Oluşturucu aracını kullanabilirsiniz.

JSON-LD Kodunu Web Sitesine Nasıl Eklersiniz?

Oluşturduğunuz kodu ilgili sayfanın HTML'ine type değeri application/ld+json olan bir script etiketiyle ekleyin. Google bu bloğu sayfanın head veya body bölümünde okuyabilir. Kodu yayımladıktan sonra canlı sayfayı Rich Results Test ile kontrol edin.

Google'ın belgesi JSON-LD için head ile body arasında bir öncelik belirtmez. Sitenizin şablonu hangi bölüme kod eklemenize izin veriyorsa o bölümü kullanabilirsiniz. Önemli olan kodun doğru sayfada yer alması ve sayfanın görünür içeriğiyle uyuşmasıdır.

  1. Araçta Kodu kopyala düğmesiyle kodu script etiketiyle birlikte kopyalayın.
  2. Kodu yalnızca tanımladığı içeriğin bulunduğu sayfaya ekleyin.
  3. Sayfada aynı varlığı tanımlayan başka bir JSON-LD bloğu olup olmadığını kontrol edin.
  4. Sayfayı yayımlayın ve canlı URL'yi Rich Results Test ile test edin.
  5. Search Console'daki ilgili zengin sonuç raporlarında geçerlilik durumunu izleyin.

WordPress'te JSON-LD nasıl eklenir?

WordPress'te kodu temanızın veya kullandığınız SEO eklentisinin yapılandırılmış veri ya da özel kod alanına ekleyebilirsiniz. Her eklenti aynı giriş alanlarını sunmaz. Bu yüzden eklentinizin belgelerine göre kodun ham JSON mu yoksa script etiketiyle birlikte mi beklendiğini kontrol edin.

Kodu normal paragraf editörüne yapıştırmak, kodun sayfada yazı olarak görünmesine veya editör tarafından silinmesine yol açabilir. Araç kodu script etiketiyle birlikte verir. Ham JSON bekleyen bir alan için kopyaladığınız koddaki ilk ve son satırı, yani script etiketlerini silin.

Pratik not

Yoast ve Rank Math gibi SEO eklentileri Article, Organization veya BreadcrumbList verisini zaten üretiyor olabilir. Yeni kod eklemeden önce canlı sayfanın kaynağında application/ld+json bloklarını arayın. Aynı varlık için çelişen bilgiler bulursanız eklentinin ayarını güncelleyin veya bloklardan birini kaldırın.

JavaScript ile eklenen schema Google tarafından okunur mu?

Evet. Google, sayfanın içeriğine JavaScript ile dinamik olarak eklenen JSON-LD verisini okuyabilir. Yine de canlı URL'yi Rich Results Test veya Search Console'daki URL Denetleme aracıyla test ederek verinin işlenen sayfada göründüğünü doğrulayın.

Etiket yöneticisi veya istemci tarafı bir uygulama ile eklenen kodları işlenmiş sayfa üzerinde test edin. Sayfa kaynağında görünmeyen bir blok işlenmiş sayfada yer alabilir. Rich Results Test bu kontrol için canlı URL ile çalıştırılabilir.

Schema Kodunun Google'a Uygunluğu Nasıl Test Edilir?

Google arama özelliklerine uygunluğu Google'ın Rich Results Test aracıyla test edersiniz. Kodun genel Schema.org yapısını Google'a özgü kontroller olmadan incelemek için Schema Markup Validator kullanılır. En güvenilir sonuç için kodu JSON sözdizimi, Schema.org yapısı ve Google gereksinimleri açısından ayrı ayrı kontrol edin.

Dört kutudan oluşan akış diyagramı. Birinci kutu JSON sözdizimi kontrolünü, ikinci kutu Schema Markup Validator ile Schema.org yapısı kontrolünü, üçüncü kutu Google Rich Results Test ile Google özellik uygunluğunu gösteriyor. Kesik çizgili dördüncü kutu arama sonucundaki gösterim kararının Google'a ait olduğunu ve hiçbir test aracının bunu önceden bildirmediğini belirtiyor.
Her kontrol seviyesi farklı bir soruyu yanıtlar. Bir seviyeden geçmek sonraki seviyenin sonucunu belirlemez.

Diyagramdaki üç kontrol farklı sorulara yanıt verir. Araç kodu her zaman geçerli JSON olarak üretir ve kontrol listesinde desteklediği türlerin zorunlu ve önerilen alanlarını denetler. Tam Schema.org sözlüğü doğrulaması yapmaz. Üçüncü seviyedeki Google gereksinimleri için resmî kaynak Rich Results Test'tir. Google'ın test belgesi, Rich Results Test'in sayfanın hangi Google zengin sonuçlarını üretebileceğini gösterdiğini, Schema Markup Validator'ın ise tüm Schema.org türlerini Google'a özgü doğrulama olmadan test ettiğini açıklar.

  1. Araçta JSON-LD kodunu oluşturun ve Kodu kopyala düğmesiyle kopyalayın.
  2. Araçtaki Google'da test et ya da Schema.org doğrulayıcı düğmesiyle Rich Results Test veya Schema Markup Validator'ı açın.
  3. Kod sekmesine kodu yapıştırın ya da kod yayımlandıysa canlı URL'yi girin.
  4. Testi başlatın ve hata ile uyarıları ayrı ayrı inceleyin.
  5. Gerekirse forma dönüp ilgili alanı düzeltin. Kod anında güncellenir, yeniden kopyalayıp test edin.

Araçtaki Google'da test et ve Schema.org doğrulayıcı düğmeleri ilgili test sayfasını açar. Kodu bu servislere otomatik olarak aktarmaz. Bu yüzden kodu kopyalayıp test aracına sizin yapıştırmanız gerekir.

İki testten geçen kod zengin sonuç alır mı?

Hayır. Google'ın yapılandırılmış veri yönergeleri, işaretlemenin arama sonuçlarında gösterileceğini garanti etmediğini açıkça belirtir. Test araçları yalnızca teknik uygunluğu gösterir. Zengin sonucu gösterip göstermeme kararını Google'ın sistemleri verir.

Aynı yönergeler yapılandırılmış verinin kullanıcıların görebildiği içeriği tanımlamasını ve sayfayı doğru temsil etmesini ister. Bu kurallara aykırı işaretleme manuel işleme yol açabilir. Google'a göre manuel işlem sayfanın zengin sonuç uygunluğunu kaldırır. Sayfanın normal web aramasındaki sıralaması bu işlemden etkilenmez. Schema Markup tek başına bir sıralama artışı vaat etmez.

Schema Markup Kullanırken Hangi Hatalardan Kaçınılmalıdır?

En sık yapılan hatalar sayfaya uymayan bir tür seçmek, sayfada görünmeyen veya gerçek olmayan bilgileri işaretlemek ve aynı varlığı birden fazla blokta çelişkili biçimde tanımlamaktır. Geçersiz JSON, eksik zorunlu alanlar ve test sonucunu zengin sonuç garantisi saymak da sık görülen sorunlardır. Bu hataların çoğu kodu sayfanın gerçek içeriğiyle yeniden karşılaştırarak düzeltilir.

Sık yapılan Schema Markup hataları ve düzeltme yolları
Hata Neden sorun yaratır Düzeltme
Yanlış tür seçmekBir blog yazısını ürün gibi işaretlemek sayfanın ana varlığını yanlış tanımlar.Sayfanın gerçek ana varlığına uyan türü seçin.
Zorunlu alanları eksik bırakmakHedeflenen Google özelliği için sayfa uygun sayılmayabilir.İlgili Google belgesindeki güncel zorunlu ve önerilen alanları kontrol edin.
Sahte puan veya yorum eklemekGoogle yönergeleri sahte yorumları yasaklar ve manuel işlem riski doğar.Yalnızca gerçek ve sayfada görünen değerlendirme verilerini kullanın.
Sayfayla uyuşmayan veri kullanmakİşaretleme sayfanın görünür içeriğini yanlış temsil eder.Fiyat, tarih, ad ve adres değerlerini canlı sayfayla eşleştirin.
Geçersiz JSON oluşturmakEksik tırnak veya fazla virgül kodun okunmasını engeller.Kodu bir JSON ayrıştırıcısıyla kontrol edin.
Aynı varlığı çelişkili tanımlamakEklenti ve elle eklenen kod aynı kuruluşa farklı adlar verebilir.Canlı sayfadaki bütün application/ld+json bloklarını inceleyin.
Test sonucunu garanti saymakUygunluk, arama sonucunda gösterim anlamına gelmez.Uygunluk ile gerçek görünüm arasındaki farkı raporlarınızda ayrı tutun.
Geçersiz URL kullanmakHatalı veya açılmayan URL'ler veri kalitesini düşürür.URL biçimini kontrol edin ve gerekirse canlı adresi tarayıcıda açın.

Tablodaki hatalardan ilk dördü kodun geçerli olduğu durumlarda bile ortaya çıkabilir. JSON sözdizimi kontrolü bu nedenle kalite kontrolünün yalnızca ilk adımıdır. Kodu yayımlamadan önce her değeri sayfadaki karşılığıyla eşleştirmek en çok sorunu önleyen adımdır.

Schema Oluşturucu ile Schema Validator Arasındaki Fark Nedir?

Schema Oluşturucu girdiğiniz bilgileri JSON-LD koduna dönüştürür. Schema Validator ise var olan bir kodun yapısını kontrol eder. Google Rich Results Test aynı kodu Google'ın desteklediği arama özellikleri açısından değerlendirir.

Teknik SEO araçlarının ana işlevleri
Araç Girdi Ana işlem
Schema / JSON-LD OluşturucuSchema türü ve form bilgileriJSON-LD kodu üretir
Schema Markup ValidatorKod veya URLGenel Schema.org işaretlemesini kontrol eder
Google Rich Results TestKod veya URLGoogle arama özelliklerine uygunluğu test eder
SERP ÖnizlemeBaşlık ve meta açıklamaTahmini arama sonucu görünümünü gösterir
OG Görsel OluşturucuBaşlık ve görsel tercihleriSosyal paylaşım görseli hazırlar

Bu sayfanın ana işlevi kod üretmektir. Doğrulama, üretilen kodu kontrol etmenizi kolaylaştıran yardımcı bir adımdır. Kodu başka bir araçla oluşturduysanız doğrudan Schema Markup Validator veya Rich Results Test ile başlamanız daha uygundur.

Schema / JSON-LD Oluşturucu Hakkında Sık Sorulan Sorular

Aşağıda aracın kullanımına ve oluşturulan kodun uygulanmasına dair sık sorulan soruların kısa yanıtları yer alır. Kavramsal açıklamalar ve test adımları yukarıdaki bölümlerde ayrıntılı olarak anlatılmıştır.

Schema Oluşturucu ücretsiz mi?

Evet. Schema / JSON-LD Oluşturucu, desteklenen türlerde kod hazırlamak ve kopyalamak için ücretsiz kullanılabilir. Kayıt gerektirmez.

JSON-LD kodu oluşturmak için yazılım bilgisi gerekir mi?

Hayır. Kodu form alanları üzerinden oluşturduğunuz için JSON-LD yazmayı bilmeniz gerekmez. Kodu sitenize eklerken ise kullandığınız içerik yönetim sistemine göre şablon veya eklenti ayarlarına erişmeniz gerekebilir.

Aynı sayfada birden fazla Schema kullanılabilir mi?

Evet. Bir sayfada Product ve BreadcrumbList gibi farklı varlıkları tanımlayan birden fazla blok bulunabilir. Her bloğun sayfanın görünür içeriğiyle uyumlu olması ve aynı varlık hakkında çelişkili bilgi içermemesi gerekir.

Yanlış Schema türü seçersem ne olur?

Kod geçerli JSON olsa bile sayfanın gerçek içeriğini yanlış tanımlar ve hedeflediğiniz Google özelliğine uygun olmayabilir. Bu durumda doğru türü seçip kodu yeniden oluşturun. Eski bloğu sayfadan kaldırmayı unutmayın.

FAQPage kodu eklemek hâlâ işe yarar mı?

Google'da SSS zengin sonucu elde etmek için işe yaramaz, çünkü Google bu görünümü 7 Mayıs 2026'dan itibaren arama sonuçlarında göstermiyor. FAQPage geçerli bir Schema.org türü olmaya devam eder. Google bu özelliğin belgesini 15 Haziran 2026'da kaldırdığı için araç FAQPage türünü ilk sürümde sunmaz.

Bu tarihler Google Search Central belge güncellemeleri sayfasında yer alır. Google'ın desteklediği özellikler zamanla değiştiği için bir türü eklemeden önce güncel arama galerisini kontrol edin.

İlgili Teknik SEO Araçları ve Rehberleri

Schema / JSON-LD Oluşturucu'yu sayfaların taranması, hedeflenmesi ve arama sonucu görünümüyle ilgili diğer teknik SEO araçlarıyla birlikte kullanabilirsiniz. Yapılandırılmış verinin teknik SEO içindeki yerini anlamak için ise ilgili rehberler daha ayrıntılı bilgi sunar.

Yapılandırılmış veri, teknik SEO çalışmalarının bir parçasıdır. Tarama ve AI arama sistemlerine teknik erişim konusunu GEO teknik optimizasyon sayfasında bulabilirsiniz. Diğer ücretsiz araçlar için araçlar sayfasını, SEO rehberlerinin tamamı için SEO merkezini ziyaret edebilirsiniz.

Kaynaklar

  1. Schema.org. Yapılandırılmış veri sözlüğü.
  2. W3C, JSON-LD 1.1. W3C önerisi, 16 Temmuz 2020.
  3. Google Search Central, Yapılandırılmış verinin işleyişine giriş. Desteklenen formatlar, JSON-LD önerisi ve dinamik ekleme. Son güncelleme 10 Aralık 2025.
  4. Google Search Central, Genel yapılandırılmış veri yönergeleri. Görünür içerik, garanti olmaması ve manuel işlemler. Son güncelleme 10 Temmuz 2026.
  5. Google Search Central, Yapılandırılmış verinizi test edin. Rich Results Test ve Schema Markup Validator farkı.
  6. Google Search Central, Arama galerisi. Google'ın desteklediği yapılandırılmış veri özellikleri.
  7. Google Search Central, Article yapılandırılmış verisi. Son güncelleme 8 Eylül 2026.
  8. Google Search Central, Ürün yapılandırılmış verisine giriş. Ürün snippet'i ve satıcı listelemesi ayrımı.
  9. Google Search Central, Ürün snippet'i yapılandırılmış verisi. Son güncelleme 8 Eylül 2026.
  10. Google Search Central, Satıcı listelemesi yapılandırılmış verisi. Zorunlu Product ve Offer alanları.
  11. Google Search Central, Yerel işletme yapılandırılmış verisi. Son güncelleme 8 Eylül 2026.
  12. Google Search Central, Kuruluş yapılandırılmış verisi. Son güncelleme 8 Eylül 2026.
  13. Google Search Central, Sayfa yolu yapılandırılmış verisi. Son güncelleme 8 Eylül 2026.
  14. Google Search Central, Belge güncellemeleri. SSS zengin sonucunun kaldırılmasına ilişkin 8 Mayıs ve 15 Haziran 2026 kayıtları.
  15. Google Rich Results Test.
  16. Schema Markup Validator.

Diğer ücretsiz araçlar

Hemen Başlayın

Büyümeyi birlikte planlayalım

Instagram, Facebook, Google ve SEO ile başlayın;

GEO ve yapay zekâ ile büyüyün

İbrahim Özkan

Dijital Pazarlama Uzmanı ve Eğitmen

SEO, GEO, performans reklamcılığı ve dijital pazarlama stratejisiyle görünürlük, müşteri edinimi ve ölçülebilir büyüme üzerine çalışıyorum.

İletişim

©2026 Tüm hakları saklıdır

Hemen Başlayın

Büyümeyi birlikte planlayalım

Instagram, Facebook, Google ve SEO ile başlayın; GEO ve yapay zekâ ile büyüyün

İbrahim Özkan

Dijital Pazarlama Uzmanı ve Eğitmen

SEO, GEO, performans reklamcılığı ve dijital pazarlama stratejisiyle görünürlük, müşteri edinimi ve ölçülebilir büyüme üzerine çalışıyorum.

İletişim

©2026 Tüm hakları saklıdır

Hemen Başlayın

Büyümeyi birlikte planlayalım

Instagram, Facebook, Google ve SEO ile başlayın;

GEO ve yapay zekâ ile büyüyün

İbrahim Özkan

Dijital Pazarlama Uzmanı ve Eğitmen

SEO, GEO, performans reklamcılığı ve dijital pazarlama stratejisiyle görünürlük, müşteri edinimi ve ölçülebilir büyüme üzerine çalışıyorum.

İletişim

©2026 Tüm hakları saklıdır