Hreflang kontrolü: hreflang etiketleri nasıl doğrulanır ve hatalar nasıl düzeltilir
Hreflang, arama motorlarına bir sayfanın hangi dil ya da bölge sürümünün kime gösterileceğini söyler. Fikir basittir. Uygulama kırılgandır: her sayfa her sürümü listelemeli, her sürüm de onu geri listelemelidir; tek bir yanlış kod ya da yönlendiren tek bir URL tüm bir seti güvenilmez hâle getirebilir. Bir hreflang kontrol aracı hepsini bir kerede okur.
Hreflang kontrol aracı ne yapar
Tek bir sayfanın hreflang etiketleri size çok az şey söyler. Önemli hatalar yalnızca sayfaları birbiriyle karşılaştırdığınızda ortaya çıkar: A sayfası B'yi listeliyor, ama B sayfası A'yı listeliyor mu? B 200 döndürüyor mu? B kendi canonical'ı mı? Bu yüzden tek bir URL için hreflang doğrulayıcı nokta kontrolleri için yararlıdır, tüm site için hreflang kontrol aracı ise bir crawler'dır.
Tam bir kontrol her sayfadaki etiketleri okur, her hedefi izler ve her set için dört soruyu yanıtlar:
- Her kod geçerli mi?
- Her sayfa kendini ve diğer her sürümü listeliyor mu?
- Her hedef linki geri veriyor mu?
- Her hedef 200 döndüren, dizine eklenebilir, kendine canonical bir URL mi?
Hreflang etiketleri nasıl çalışır
Google'ın sayfalarınızın yerelleştirilmiş sürümleri rehberi hreflang'i bildirmenin üç yolunu anlatır. Her set için birini seçin.
| Yöntem | HTML sayfaları | PDF'ler ve dosyalar | Bulunduğu yer |
|---|---|---|---|
| Link etiketleri | ✓ | – | HTML head |
| HTTP Link header'ı | ✓ | ✓ | Sunucu yanıtı |
| XML site haritası | ✓ | ✓ | Site haritası dosyası |
1. HTML head içinde link etiketleri
<link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<link rel="alternate" hreflang="en-gb" href="https://example.com/en-gb/pricing/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" />
Aynı dört satır, x-default olan dahil dört sayfanın hepsine konur.
2. HTTP Link header'ı
HTML head'i olmayan PDF'ler ve diğer dosyalar için kullanışlıdır:
Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
<https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"
3. XML site haritası
<url>
<loc>https://example.com/en-us/pricing/</loc>
<xhtml:link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
</url>
Site haritasının urlset öğesinde xhtml namespace'inin bildirilmesi gerekir ve her url girdisi tüm seti tekrarlar. Site haritaları büyük setleri sayfa head'inin dışında tutar, ama sayfalar değiştiğinde unutulmaları kolaydır.
Her hreflang setinin uyması gereken kurallar
- Kendine referans. Google, her sürümün diğer tüm sürümlerin yanı sıra kendini de listelemesi gerektiğini söylüyor.
- Geri dönüş linkleri. A sayfası B'yi gösteriyorsa B de A'yı geri göstermelidir. Google, iki sayfa birbirini göstermiyorsa etiketlerin yok sayılabileceğini söylüyor.
- Tam URL'ler. /de/ değil, https://example.com/de/.
- Sağlıklı hedefler. Her hedef 200 döndürmeli, dizine eklenebilir olmalı ve kendi canonical'ı olmalıdır. Bir yönlendirmeyi, 404'ü ya da noindex sayfayı gösteren bir etiket, arama motorlarının etrafından dolaşmak zorunda kaldığı bir sinyaldir.
- Eşdeğer sayfa. Almanca fiyat sayfası Fransızca ana sayfayı değil, Fransızca fiyat sayfasını göstermelidir.
Kodlar sabit standartları izler. Google bunları yerelleştirilmiş sürümler rehberinde listeler:
| Kod | Standard | Örnek | Geçerli |
|---|---|---|---|
| Dil | ISO 639-1 | de, pt | ✓ |
| Dil ve bölge | ISO 3166-1 Alpha 2 | de-at, pt-br | ✓ |
| Dil ve yazı sistemi | ISO 15924 | zh-Hant | ✓ |
| Yalnızca bölge | yok | us | – |
| Birleşik Krallık | UK değil, GB | en-uk | – |
| Yedek | Ayrılmış değer | x-default | ✓ |
x-default: yedek sürüm
x-default, setteki başka hiçbir dil ya da bölge ziyaretçiyle eşleşmediğinde gösterilecek sayfa için ayrılmış bir değerdir. Google bunu dil seçici sayfaları ve ziyaretçileri diline ya da konumuna göre yönlendiren sayfalar için önerir.
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
İsteğe bağlıdır, ama ana sayfada ve dil seçicisi olan her sayfada iyi bir fikirdir. Diğer her hedef gibi x-default URL'si de 200 döndürmeli, dizine eklenebilir olmalı ve kendi canonical'ı olmalıdır; setteki her sayfa da aynı x-default'u göstermelidir. Yaygın bir hata, x-default'u ziyaretçileri konuma göre yönlendiren bir URL'ye bağlamak ve o yönlendirmenin bir hatada bitmesine izin vermektir.
En yaygın hreflang hataları
| Hata | Görünümü | Düzeltme |
|---|---|---|
| Geri dönüş linki yok | de, en-us'ı listelemiyor | Her set için tek ortak liste |
| Kendine referans yok | Sayfa kendini listelemiyor | Kendi URL'sini ekleyin |
| Yanlış bölge kodu | en-uk | en-gb |
| Dil olmadan bölge | hreflang="us" | en-us |
| Göreli URL | /de/ | Tam https URL'si |
| Hedef yönlendiriyor ya da hata veriyor | Fransızca URL 301 veriyor | Son URL |
| Hedef başka bir URL'ye canonical edilmiş | Parametreli URL | Canonical URL |
| Tek kod, iki URL | de etiketli iki sayfa | Kod başına bir URL |
| Head dışında etiketler | Script head'i erken bitiriyor | Yukarı taşıyın ya da header kullanın |
| Dil uyuşmazlığı | hreflang fr, html lang en | Sayfa metniyle eşleştirin |
SEO ProCheck'in hreflang ve uluslararası SEO uygulama rehberi bunların her birini daha ayrıntılı anlatır.
Hreflang ve canonical'lar
Hreflang ve canonical etiketleri birlikte çalışır ve birbirini kolayca bozar. Her dil sürümü kendi canonical'ı olmalıdır. Almanca sayfa canonical olarak İngilizce sayfayı gösteriyorsa, arama motorlarına Almanca sayfanın bir kopya olduğunu söylüyorsunuz; bu da hreflang'ine karşı çalışır. Canonical bir dil içinde işaret eder; hreflang diller arasında işaret eder.
Ayrıca bir hreflang setindeki her URL'nin canonical sürüm olduğunu kontrol edin: aynı protokol, aynı host, aynı sondaki eğik çizgi. http ve https URL'lerini ya da eğik çizgili ve eğik çizgisiz URL'leri karıştıran bir set, sayfalar doğru olsa bile geri dönüş linki kontrolünden geçemez, çünkü URL'ler birebir eşleşmez.
Tüm sitede hreflang nasıl kontrol edilir
- Her dil sürümünü tarayın. Her dil kendi alan adında ya da alt alan adında yaşıyorsa hepsini taramaya dahil edin; yoksa geri dönüş linkleri kontrol edilemez.
- Hreflang'i kullandığınız her yöntemden okuyun: HTML head, HTTP Link header'ı ve site haritaları. İki şekilde bildirilen bir set, kendisiyle çelişebilecek bir settir.
- Önce kodları doğrulayın. Bir şablonun tekrarladığı tek bir yanlış kod binlerce sayfayı etkileyebilir.
- Geri dönüş linklerini ve kendine referansları her sayfa için kontrol edin.
- Hedeflerin sağlığını kontrol edin: her hedefin durumu, dizine eklenebilirliği ve canonical'ı.
- Eksik setlere bakın: başka dillerde eşdeğeri olan ama hiç hreflang'i olmayan sayfalar.
- Şablon ya da eklenti düzeyinde düzeltin, sayfa sayfa değil; sonra yeniden tarayın.
Bunu kendi sitemizde yapıyoruz. neova.app 15 dilde çalışıyor. 20 Kasım 2026'daki SEO turumuzda XML site haritaları 1.358 URL listeliyordu ve her hreflang linki geri veriliyordu: tamamen karşılıklı. 15 sürümle her sayfa, kendisi dahil 15 URL listeler ve bunların her biri onu geri listelemelidir. Bir setteki her etiketi tek bir ortak listeden üretin, geri dönüş linkleri kendiliğinden gelir.
Hreflang setleri teknik SEO denetimi kontrol listesinin 12. adımıdır. Dil sürümleriniz ziyaretçileri yönlendiriyorsa yönlendirme zincirleri rehberini de okuyun.
Hreflang'i Neova ile kontrol edin
Neova'nın Uluslararası kategorisi her sayfanın dil ve bölge sürümlerini ve birbirlerini gösterip göstermediklerini gösterir. Hreflang'i HTML head'den ve HTTP Link header'ından okur, her HTML sayfasına Hreflang dilleri ve Hreflang hedefleri sütunlarını ekler ve html lang'i hreflang'e ve sayfanın kendi metnine karşı kontrol eder. Kontrollerden bazıları:
- Hreflang geri dönüş linki eksik ve Hreflang kendine referans eksik
- Hreflang dil kodu geçersiz ve Hreflang ülke kodu geçersiz
- Hreflang 200 olmayan bir URL'yi gösteriyor ve Hreflang başka yere canonical edilmiş bir URL'yi gösteriyor
- Hreflang genel yedek hedefi bozuk, noindex, canonical edilmiş ya da tutarsız
- Hreflang eşdeğer URL'yi değil, bir dil kökünü gösteriyor
- Hreflang ve HTML lang dilde uyuşmuyor
- Yerel eşdeğerler varken hreflang eksik
Her işaret neden önemli olduğunu, nasıl düzeltileceğini ve kaynağını söyler; her tablo, şablonu düzelten geliştirici için CSV'ye ya da Excel'e aktarılır. Neova, Ücretsiz dahil her planda 694 kontrolün hepsini çalıştırır:
| Neova | |
|---|---|
| Platformlar | |
| Kontroller | 694 |
| Ücretsiz plan | Tarama başına 1.000 URL |
| Arayüz dilleri | 15 |
Mac, Apple silicon demektir; tarayıcıda aynı hesapla Neova Online kullanılır. Özellikler, Fiyatlandırma sayfalarına bakın ya da Neova'yı indirin.
Sorular
Hreflang kontrol aracı nedir?
Bir sitenin hreflang etiketlerini okuyan ve onları birbirine karşı kontrol eden bir araç: geçerli dil ve bölge kodları, kendine referanslar, geri dönüş linkleri, x-default ve her hedefin 200 döndürüp döndürmediği, dizine eklenebilir olup olmadığı ve kendi canonical'ı olup olmadığı.
Hreflang geri dönüş linkleri nedir?
A sayfası B'yi alternatif olarak listeliyorsa B sayfası da A'yı listelemelidir. Google, iki sayfa birbirini göstermediğinde hreflang etiketlerinin yok sayılabileceğini söylüyor.
x-default zorunlu mu?
Hayır, isteğe bağlıdır. Dil seçici sayfaları, ana sayfalar ve ziyaretçileri dile ya da konuma göre yönlendiren sayfalar için önerilir; böylece arama motorları başka hiçbir şey eşleşmediğinde hangi sürümü göstereceğini bilir.
en-uk mı yoksa en-gb mi kullanmalıyım?
en-gb. Bölge kısmı ISO 3166-1 Alpha 2 ülke kodudur ve Birleşik Krallık'ın kodu GB'dir. en-uk geçerli bir değer değildir. Bunun gibi başka yanıtlar SEO ProCheck'teki hreflang ve uluslararası SEO SSS sayfasında.
Hangi hreflang yöntemi en iyisi?
Üçü de Google için işe yarar: HTML head'de link etiketleri, HTTP Link header'ı ya da XML site haritası. Her set için tek yöntem kullanın. Link etiketlerini kontrol etmek en kolayıdır, header PDF'lere uyar, site haritaları büyük setleri sayfanın dışında tutar.