Sitenizin İngilizce sürümünü yayına aldınız, ama Google Londra'daki bir kullanıcıya hâlâ Türkçe sayfayı gösteriyor. Ya da tam tersi: Türkiye'den arama yapan biri, arama sonuçlarında İngilizce başlığa tıklıyor ve birkaç saniye içinde siteden çıkıyor. İçerik doğru, çeviri doğru, ama arama motoru hangi sürümün kime ait olduğunu bilmiyor.
Bu sorunun teknik adı hreflang. Birkaç satırlık bir etikettir, ama çok dilli sitelerde en sık yanlış kurulan SEO ayarlarından biridir. Bu yazıda hreflang nedir, nasıl yazılır, en yaygın hatalar nelerdir ve nasıl test edilir, adım adım anlatıyoruz. Sonunda da Sem CMS'in hreflang etiketlerini nasıl otomatik ürettiğini gösteriyoruz.
Kısaca: hreflang, aynı sayfanın farklı dil veya bölge sürümlerini arama motoruna birbirine bağlı olarak bildiren etikettir. Her sürüm, kendisi dahil tüm sürümleri listelemeli; bağlantılar karşılıklı olmalı; yalnızca yayında, dizine açık ve 200 dönen adreslere işaret etmeli; dil kodları ISO standardına uymalı. Etiket bir sıralama faktörü değildir, doğru sürümün doğru kullanıcıya gösterilmesini sağlar.
hreflang nedir, ne işe yarar?
hreflang, bir sayfanın başka dillerdeki veya başka bölgelere yönelik karşılıklarını arama motoruna söyleyen bir HTML özelliğidir. Örneğin bir hizmet sayfanız Türkçe, İngilizce ve Almanca olarak yayındaysa, üç sürüm de diğer ikisini hreflang ile işaret eder. Google bu bilgiyi kullanarak, kullanıcının diline ve konumuna en uygun sürümü arama sonuçlarında gösterir.
Burada önemli bir ayrım var: hreflang sıralamayı yükseltmez. Yaptığı şey, zaten sıralanan bir sayfanın yanlış dildeki kopyası yerine doğru dildeki sürümünün gösterilmesini sağlamaktır. Sonuç dolaylıdır ama gerçektir: Doğru dilde açılan sayfa daha çok tıklanır, ziyaretçi daha uzun kalır, dönüşüm artar.
hreflang aynı zamanda aynı dilin farklı bölgeleri için de kullanılır. İngiltere ve ABD'ye ayrı fiyat ve yazım kurallarıyla hitap eden iki İngilizce sayfa neredeyse aynı metni taşıyabilir. hreflang, bu sayfaların birbirinin kopyası değil, farklı kitlelere yönelik sürümler olduğunu açıklar.
hreflang etiketi nasıl yazılır?
En yaygın yöntem, sayfanın <head> bölümüne her dil sürümü için bir link etiketi eklemektir:
<link rel="alternate" hreflang="tr" href="https://ornek.com/hizmetler/ic-mimarlik" />
<link rel="alternate" hreflang="en" href="https://ornek.com/en/services/interior-design" />
<link rel="alternate" hreflang="x-default" href="https://ornek.com/hizmetler/ic-mimarlik" />
Bu üç satır, Türkçe ve İngilizce sayfaların her ikisinde de aynen yer almalıdır. Her sayfa önce kendini, sonra diğer sürümleri listeler.
Üç uygulama yöntemi
| Yöntem | Nerede? | Ne zaman uygun? |
|---|---|---|
HTML link etiketi | Sayfanın <head> bölümü | Çoğu web sitesi için standart yöntem |
| HTTP başlığı | Sunucu yanıtındaki Link başlığı | PDF gibi HTML olmayan dosyalar |
| XML site haritası | xhtml:link öğeleri | Çok büyük siteler, <head> düzenlenemiyorsa |
Üç yöntem de aynı sonucu verir; birini seçip tutarlı biçimde uygulamak yeterlidir. Aynı siteyi iki yöntemle işaretlemek, ikisi çeliştiğinde hata ayıklamayı zorlaştırır.
Dil ve bölge kodları
- Dil kodu ISO 639-1 standardındadır ve zorunludur:
tr,en,de,ar. - Bölge kodu isteğe bağlıdır, ISO 3166-1 Alpha-2 standardındadır ve dilden sonra gelir:
en-GB,de-AT,pt-BR. - Yalnızca bölge kodu kullanılamaz:
hreflang="gb"geçersizdir, çünkü "gb" bir dil değildir. - Sık yapılan yanlış: Birleşik Krallık için
en-UKdeğil,en-GByazılır. - Bölge ayrımı yapmıyorsanız yalnızca dil kodu kullanın. Tek bir İngilizce sayfanız varsa
en, bütün İngilizce konuşan kullanıcıları kapsar.
x-default nedir?
x-default, kullanıcının dili listedeki sürümlerin hiçbiriyle eşleşmediğinde gösterilecek sayfayı belirtir. Genellikle sitenin ana dilindeki sürüm ya da bir dil seçim sayfasıdır. Zorunlu değildir, ama Japonca konuşan bir ziyaretçinin Türkçe ve İngilizce arasında rastgele bir sürüme düşmemesi için önerilir.
Doğru kurulum için 6 kural
- Karşılıklılık: A sayfası B'yi işaret ediyorsa, B de A'yı işaret etmelidir. Tek yönlü bağlantılar yok sayılabilir.
- Kendine referans: Her sayfa, listede kendisini de içermelidir.
- Tam adres:
hrefdeğerleri protokol ve alan adı dahil tam URL olmalıdır. Göreli yollar hataya açıktır. - Yalnızca canlı sayfalar: İşaret edilen adres 200 dönmeli, dizine açık olmalı (noindex olmamalı) ve yönlendirme yapmamalıdır.
- Canonical ile uyum: Her dil sürümünün canonical etiketi kendisini göstermelidir. İngilizce sayfanın canonical'ı Türkçe sayfaya işaret ederse, hreflang sinyali boşa gider.
- Tutarlı adres biçimi: Bir yerde
http://, bir yerdehttps://; bir yerdewww, bir yerdewww'siz adres kullanmak, aynı sayfanın farklı URL'ler gibi görünmesine yol açar.
En yaygın hreflang hataları
- Çevrilmemiş sayfaları listelemek: İngilizce sürüm henüz yazılmamışken etiketin ana sayfaya ya da boş bir sayfaya işaret etmesi. Var olmayan bir sürümü hiç listelememek gerekir.
- Tüm dilleri ana sayfaya bağlamak: Her sayfanın hreflang'ının, o sayfanın karşılığı yerine sitenin ana sayfasına gitmesi. Kategori ve liste sayfalarında özellikle sık görülür.
- Silinmiş veya yönlendirilmiş adresler: Slug değiştiğinde hreflang etiketlerinin eski adreste kalması.
- Karışık protokol ve alan adı: Etiketlerde
http://veya farklı bir alan adı kullanılması. - IP'ye göre otomatik yönlendirme: Ziyaretçiyi konumuna göre zorla başka dile yönlendirmek, arama motoru botlarının bazı sürümleri hiç görememesine yol açabilir. Kullanıcıya dil önermek, zorla yönlendirmekten daha güvenlidir.
- Elle tutulan listeler: Bir dil eklendiğinde ya da kaldırıldığında yüzlerce sayfanın etiketlerini elle güncellemeye çalışmak. Ölçek büyüdükçe bu yöntem mutlaka bozulur.
hreflang nasıl test edilir?
Kontrol için birkaç pratik yol vardır:
- Kaynak kodu: Her dil sürümünün kaynak kodunu açıp hreflang satırlarının aynı seti içerdiğini, adreslerin doğru olduğunu kontrol edin.
- URL Denetimi: Search Console'daki URL Denetimi aracı, Google'ın sayfayı nasıl gördüğünü ve hangi canonical'ı seçtiğini gösterir. Google'ın seçtiği canonical sizin belirttiğinizden farklıysa, hreflang kurulumunu da gözden geçirin.
- Site tarayıcıları: Masaüstü SEO tarama araçları, karşılık bağlantısı eksik, 404 dönen veya yönlendirilen hreflang hedeflerini toplu olarak raporlar.
Search Console'daki eski "Uluslararası Hedefleme" raporu kullanımdan kaldırıldığı için, düzenli bir tarama yapmak bugün en güvenilir kontrol yöntemidir.
Sem CMS hreflang etiketlerini nasıl üretir?
Yukarıdaki kuralların çoğu, etiketler elle yazıldığında bozulur. Sem CMS'te hreflang etiketlerine dokunmanız gerekmez; sistem her sayfa için onları içeriğin gerçek durumundan üretir.
Bir dil sürümü yalnızca üç koşul birlikte sağlandığında etikete eklenir: dil sitede aktiftir, içeriğin o dilde bir slug'ı vardır ve içerik o dilde yayına alınmıştır. İngilizce çevirisi hazır olmayan bir yazı, İngilizce hreflang satırı üretmez. Bir dili pasif yaptığınızda, o dil tüm kayıtların yayın dillerinden çıkarılır ve etiketlerden de kaybolur.

Her dil sürümünde aynı set üretildiği için karşılıklılık ve kendine referans kendiliğinden sağlanır. x-default otomatik eklenir ve varsayılan dildeki sürümü gösterir; içerik o dilde yayında değilse yayındaki başka bir sürüme düşer. Varsayılan dil URL öneki olmadan yayınlanır, diğer diller kendi önekleriyle.

Hata listesindeki diğer maddeler de sistem düzeyinde ele alınır:
- Liste sayfaları: Bir modülün liste sayfasında hreflang, ana sayfaya değil her dilin kendi liste adresine işaret eder.
- Adres biçimi: Canonical ve hreflang adresleri her zaman sitenin ana alan adı ve protokolüyle üretilir;
http://veya/index.phpiçeren kopyalar etiketlere girmez. Siteninwww'li vewww'siz eşlerinden ana adres olmayanına gelen istekler, ana adrese 301 ile yönlendirilir. - Slug değişiklikleri: Etiketler içeriğin güncel slug'ından üretilir; eski adres için de her dilde bir 301 kaydı hazırlanır.
- 404 sayfaları: Bulunamayan sayfalar canonical veya hreflang etiketi üretmez.
Dil değiştirici de aynı mantıkla çalışır: Temalar yalnızca o sayfanın çevrildiği dilleri gösterir, sitede tek dil varsa değiştirici hiç görünmez. Ziyaretçi, var olmayan bir sürüme yönlendirilmez.
Sonuç: hreflang bir kez doğru kurulmalı, sonra kendi kendine doğru kalmalı
hreflang'in kuralları basittir: karşılıklı, kendine referanslı, tam adresli ve yalnızca canlı sayfalara işaret eden etiketler. Zor olan, bu kuralları yüzlerce sayfa, her yeni çeviri ve her slug değişikliğinde korumaktır. Etiketleri içeriğin yayın durumundan üreten bir sistem, bu işi bir kontrol listesinden çıkarıp altyapıya taşır.
Çok dilli yönetimin bütününü çok dilli web sitesi yönetimi yazımızda, canonical ve meta etiketlerini SEO dostu CMS yazımızda bulabilirsiniz. Çeviriyi yerelleştirmeye dönüştürmek için çok dilli içerik stratejisi rehberimize göz atın. Tüm özellikler için Özellikler sayfamızı inceleyin veya demo talep edin.