Rehber

Hreflang nasıl kurulur? Çok dilli sitelerde sık yapılan hatalar

Dil ve bölge sürümlerini Google'a ve Yandex'e nasıl bildirirsiniz? Kod seçimi, karşılıklı bağlantı, canonical uyumu, otomatik yönlendirme tuzağı ve Türkiye'ye özgü bir yöntem tercihi.

Fratres Editör · 11 Kasım 2026

Hreflang, bir sayfanın farklı dil veya bölge sürümlerini arama motoruna bildiren bağlantı özelliğidir (rel="alternate" hreflang="..."). Google bu bilgiyle kullanıcıyı dil ve bölgesine uygun sürüme yönlendirebilir. Doğru kurulumun üç şartı var: Her sürüm kendisi dahil bütün sürümleri listeler, bağlantılar karşılıklıdır ve kodlar ISO standardına uyar.

Hreflang ne işe yarar, ne işe yaramaz?

Google'ın belgesi üç durumda hreflang önerir: Ana içerik tek dilde kalıp yalnız menü ve alt bilginin çevrildiği sayfalar, aynı dilde küçük bölgesel farklar taşıyan sayfalar (ABD, İngiltere ve İrlanda için İngilizce gibi) ve tamamen çevrilmiş siteler. Google hiçbir şey yapılmasa da alternatif sürümleri bulabilir, ama açıkça belirtmek genellikle en iyi yoldur.

Hreflang'in yapmadığı işler de önemli:

Dili belirlemez. Google sayfa dilini hreflang'den veya HTML lang özelliğinden değil, görünür içerikten çıkarır. Aynı sayfada iki dili yan yana sunmak bu tespiti zorlaştırır.
Kesin coğrafi hedefleme vermez. Aynı belge coğrafi hedeflemenin çok kesin sonuç vermediğini, kullanıcının yanlış sürüme düşebileceğini hesaba katmayı söyler. Bu yüzden her sayfada görünür bir dil seçici gerekir.
Çevrilmemiş içeriği kurtarmaz. Yerelleştirilmiş sürümler, ana içerik çevrilmeden kaldığında kopya sayılır.

Kullanım hızla yayılıyor. HTTP Archive Web Almanac 2025, masaüstü sayfaların ham HTML'inde %20,3 oranında hreflang buldu. Bir önceki yıl oran %9-10 civarındaydı.

Hangi yöntemi seçmeli?

Google üç yolu kabul eder ve üçünü de eşdeğer sayar. Üçünü birden kullanmak arama tarafında fayda sağlamaz, yalnız bakım yükünü artırır.

HTML <link> öğeleri: Her sürümün <head> bölümüne, kendisi dahil tüm sürümleri gösteren aynı bağlantı grubu eklenir. Sayfa sayısı az, sürüm sayısı sınırlı sitelerde en sade yoldur. Bağlantılar düzgün kurulmuş bir <head> içinde olmalı.
HTTP üstbilgisi: Link: yanıt başlığıyla verilir. PDF gibi HTML olmayan dosyalar için kullanışlıdır.
XML site haritası: Her URL için bir <loc> ve kendisi dahil tüm sürümleri listeleyen <xhtml:link> alt öğeleri yazılır. xmlns:xhtml ad alanı tanımlanmalıdır. Bu alt öğeler site haritasının URL sınırına sayılmaz. Büyük sitelerde sayfa kodunu şişirmeden yönetmeyi kolaylaştırır; ayrıntılar XML site haritası yazımızda.

Türkiye'yi hedefleyen siteler için bu tercih, aşağıda anlatacağımız Yandex nedeniyle eşdeğer değildir.

Adım adım kurulum

Sürüm haritasını çıkarın. Her sayfa için hangi URL'nin hangi dil ve bölgeye ait olduğunu bir listede toplayın. Varsayımsal örnek: Türkçe ana site /tr/, genel İngilizce /en/, Almanya'daki Türkçe konuşan kullanıcılar için ayrı fiyatlı /de-tr/ sürümü.
Kodları doğru seçin. İlk kod ISO 639-1 biçiminde dildir, isteğe bağlı ikinci kod ISO 3166-1 Alpha 2 biçiminde bölgedir. Türkçe için tr, Türkiye'deki Türkçe konuşanlar için tr-TR, Almanya'daki Türkçe konuşanlar için tr-DE. Bu standartlarda olmayan kodlar, örneğin Latin Amerika İspanyolcası için kullanılan es-419, desteklenmez.
Genel dil sürümü ekleyin. en-GB ve en-US gibi bölgesel sürümleriniz varsa, diğer ülkelerdeki İngilizce konuşanlar için bir de bölgesiz en sayfası tanımlayın. Bu, bölgesel sayfalardan biri de olabilir.
x-default belirleyin. Hiçbir sürümle eşleşmeyen kullanıcılar için yedek sayfadır. Google'a göre en iyi sonucu dil seçme sayfalarında verir.
Tam URL yazın. Protokol dahil tam adres gerekir: https://ornek.com/en/ doğru, /en/ veya //ornek.com/en/ yanlış. Sürümlerin aynı alan adında olması gerekmez.
Karşılıklılığı sağlayın. A sayfası B'yi gösteriyorsa B de A'yı göstermelidir. Google, iki sayfa birbirini göstermediğinde etiketleri yok sayar. Bunun nedeni, başka bir sitenin kendini sizin sayfanızın alternatifi ilan edememesidir.
Canonical ile uyumlu tutun. Her dil sürümünün canonical'ı kendisini göstermeli. Google, hreflang kullanıyorsanız aynı dilde bir standart sayfa belirtmenizi ister. Aynı dildeki bölgesel varyantlar için standartlaştırma belgesi canonical ile hreflang'i birlikte kullanmayı önerir. Ayrıntıları canonical etiketi yazımızda anlattık.
Otomatik yönlendirmeyi kapatın. Google, kullanıcının dilini tahmin edip başka sürüme yönlendirmemeyi, IP'ye göre içerik değiştirmemeyi önerir. Gerekçe teknik: Googlebot çoğunlukla ABD'den tarar ve isteklerinde Accept-Language başlığı göndermez. Otomatik yönlendirme, Google'ın diğer sürümleri hiç görmemesine yol açabilir.

Türkiye'de durum: Yandex site haritasını okumuyor

Türkiye'de arama yalnız Google'dan ibaret değil. StatCounter, Ekim 2026'da Türkiye'deki arama motoru payını Google için %76,85, Yandex için %21,63 olarak gösteriyor.

Yandex Webmaster belgesi, dil sürümleri için site haritası dosyasını artık desteklemediğini açıkça yazıyor ve sayfa içi işaretlemeyi öneriyor. Yandex de her sürümde tüm alternatiflerin listelenmesini istiyor ve ISO 639-1 ile ISO 3166-1 Alpha-2 kodlarını kullanıyor. Belgedeki örneklerden biri Türkiye'deki kullanıcılar için Türkçe sayfayı gösteren tr-tr kodu.

Pratik sonucu şu: Türkiye pazarına da hitap eden çok dilli bir sitede hreflang'i yalnız site haritasıyla vermek Google için yeterli, Yandex için değil. İki arama motorunu tek kurulumla karşılamanın yolu HTML <head> yöntemidir. Site haritasında zaten hreflang varsa, onu kaldırmadan önce HTML işaretlemesini eksiksiz yayına alın.

İhracat yapan işletmeler için bir uyarı daha: Yandex, dili kullanıcının IP adresinden veya tarayıcı ayarından otomatik seçen sayfalar için x-default önerir. Google ise otomatik yönlendirmeden kaçınmayı öneriyor. İki tavsiyeyi aynı anda karşılamanın yolu, kök adresi yönlendirmesiz bir dil seçme sayfası olarak bırakıp onu x-default yapmaktır.

Nasıl test edilir ve ölçülür?

Search Console'da hreflang durumunu doğrudan gösteren bir rapor yok. Türkçe yardım sayfası, Search Console'un alternatif dil sayfalarını algılamadığını belirtir. Google'ın belgesi hata ayıklama için üçüncü taraf araçları örnek verir ve bunların Google'a ait olmadığını hatırlatır. Ölçümü bu yüzden üç katmanda kurun:

Tarama aracıyla toplu kontrol: Her hreflang hedefinin 200 durum kodu döndürdüğünü, karşılıklı bağlantıların tam olduğunu ve her sürümün canonical'ının kendisini gösterdiğini doğrulayın.
URL Denetleme: Her dil sürümü için Google'ın seçtiği standart URL'ye bakın. Almanca sayfanın standart adresi Türkçe sayfaysa Google iki sayfayı kopya saymıştır. Bu çoğunlukla ana içeriğin çevrilmediğini gösterir.
Performans raporu: Ülke filtresiyle her pazarda gösterim alan sayfaların doğru dil klasöründen gelip gelmediğine bakın. Almanya'dan gelen gösterimlerin /tr/ sayfalarına düşmesi, oradaki Türkçe konuşan kitle nedeniyle olağan olabilir. Ama İngilizce sorgularda Türkçe sayfa görünüyorsa kurulumda açık var.

Sık yapılan hatalar

Dönüş bağlantısını unutmak. Google bunu yaygın hatalar listesinin başına koyar. Yeni eklenen dil sayfalarının ana dil sayfalarıyla karşılıklı bağlanmasının önemini de ayrıca vurgular.
Ülke kodunu tek başına yazmak. İlk kod her zaman dildir ve Google ülke kodundan dil türetmez. Hreflang değerinde büyük-küçük harf de fark etmez. Türkiye'deki İngilizce okurlar için hazırlanmış bir sayfaya hreflang="TR" yazmak, onu Türkçe sayfa ilan eder. Doğrusu en-TR.
Geçersiz bölge kodu kullanmak. Birleşik Krallık için UK değil GB yazılır. EU ve UN gibi ayrılmış kodlar yok sayılır.
Göreli adres vermek. Alternatif URL'ler protokol dahil tam adres olmalı, /en/ gibi yollar yetmez.
Özellikleri tek etikette birleştirmek. media gibi başka bir özelliği hreflang ile aynı <link> etiketine koymayın.
Bütün dil sürümlerini tek canonical'a bağlamak. Bu, diğer dilleri kopya ilan eder ve hreflang kümesiyle çelişir.
Şablonu çevirip içeriği aynı bırakmak. Yalnız menüsü değişen sayfalar kopya sayılabilir. Ayrı pazar için ayrı sayfa açılacaksa içeriğin de o pazara yazılması gerekir.

Yarın: Üç sayfada karşılıklılık testi yapın

Sitenizden üç sayfa seçin: ana sayfa, bir ürün veya hizmet sayfası, bir blog yazısı. Her birinin her dil sürümünde kaynak kodunu açıp hreflang listesini yan yana yazın. Listeler birebir aynı mı, her sürüm kendini içeriyor mu, kodlar geçerli mi, canonical kendini mi gösteriyor? Türkiye'yi de hedefliyorsanız hreflang'in yalnız site haritasında mı yoksa <head> içinde de mi olduğunu not edin. Üç sayfada bulduğunuz hata, büyük ihtimalle bütün şablonda vardır ve bir uluslararası SEO planının ilk maddesi olur.