Çok dilli veya çok bölgeli bir web sitesi yönetiyorsanız, Google’ın hangi sayfanın hangi kullanıcıya gösterileceğini nasıl öğrendiğini hiç merak ettiniz mi? Cevap büyük ölçüde hreflang etiketinde gizlidir. Hreflang, arama motorlarına “bu sayfa Türkçe konuşan kullanıcılar için; şu sayfa ise Almanya’daki Almanca konuşanlar için” bilgisini ileten bir HTML özniteliğidir. Doğru uygulandığında uluslararası SEO’nun bel kemiğini oluşturur; yanlış uygulandığında ise içerik çoğaltma sorunlarına, düşen sıralamaya ve kullanıcıların yanlış dil sürümüyle karşılaşmasına yol açar.

Bu rehberde hreflang’ı sıfırdan ele alacak; dil ve bölge kodları arasındaki farkı, üç farklı uygulama yöntemini, çift yönlü referans zorunluluğunu, subdomain/subdirectory/ccTLD yapı seçimlerini, en sık yapılan hataları ve test araçlarını ayrıntılı kod örnekleriyle açıklayacağız.

Hreflang Nedir ve Ne İşe Yarar?

Hreflang, 2011 yılında Google tarafından duyurulan ve sayfalar arasındaki dil ile bölge ilişkisini arama motorlarına bildiren bir HTML özniteliğidir. Tam adıyla rel="alternate" hreflang="x" biçiminde yazılır ve birden fazla dil ya da bölge versiyonu olan sayfaların birbirini işaret etmesini sağlar.

Hreflang olmadan Google şunu anlamaya çalışır: “Bu iki sayfa neredeyse aynı içeriğe sahip — acaba bunlardan birini spam olarak mı değerlendirmeliyim?” Hreflang etiketleri sayesinde Google şunu anlar: “Bu iki sayfa, farklı dil veya bölge hedefleyen kasıtlı alternatiflerdir.”

Hreflang’ın Temel Faydaları

Doğru kullanıcıya doğru sayfa: Türkiye’deki kullanıcı /tr/ sayfasını, Almanya’daki kullanıcı /de/ sayfasını görür.
Yinelenen içerik riskini azaltır: Çok dilli içerik, dikkatli yapılandırılmadığında duplicate content sinyali üretir. Hreflang bu riski bertaraf eder.
Trafik kalitesini artırır: Kullanıcı kendi dilinde içerikle karşılaşınca hemen çıkma oranı düşer, dönüşüm oranı yükselir.
Konsolidasyonu destekler: Sayfa otoritesi çoğaltılmak yerine doğru versiyona yönlendirilir.

Hreflang yalnızca Google ve Yandex tarafından desteklenmektedir. Bing kendi yöntemini (Content-Language HTTP başlığı) tercih etse de hreflang etiketlerini okuyabilir.

Dil Kodu mu, Bölge Kodu mu? Fark Nedir?

Hreflang değerleri iki parçadan oluşabilir: dil kodu ve isteğe bağlı bölge kodu.

Dil Kodları (ISO 639-1)

ISO 639-1 standardına göre iki harfli kısaltmalardır. Örnekler:

Dil	Kod
Türkçe	`tr`
Almanca	`de`
İngilizce	`en`
Fransızca	`fr`
Arapça	`ar`
İspanyolca	`es`
Japonca	`ja`

Bölge Kodları (ISO 3166-1 Alpha-2)

ISO 3166-1 Alpha-2 standardına göre iki harfli ülke kısaltmalarıdır. Örnekler:

Ülke	Kod
Türkiye	`TR`
Almanya	`DE`
Avusturya	`AT`
İsviçre	`CH`
Amerika Birleşik Devletleri	`US`
Birleşik Krallık	`GB`

Yalnızca Dil mi, Dil + Bölge mi?

Bu soru çok dilli SEO stratejisinin en kritik kararlarından biridir.

Yalnızca dil kodu kullanımı (hreflang="tr"): Türkiye, Kuzey Kıbrıs ve Almanya’daki Türkçe konuşan tüm kullanıcılara tek bir sayfayı hedefler. Bölgeye göre farklılaştırılmış içerik yoksa tercih edilir.

Dil + bölge kodu kullanımı (hreflang="tr-TR"): Yalnızca Türkiye’deki Türkçe konuşan kullanıcıları hedefler. Almanya’daki Türkçe konuşan kullanıcılar için ayrıca hreflang="tr-DE" kullanmak gerekir.

Pratik kural: Farklı ülkelere göre fiyat, para birimi, telefon numarası veya hukuki içerik farklılaştırıyorsanız dil+bölge kombinasyonu kullanın. Yalnızca dil farklılaştırması yapıyorsanız tek başına dil kodu yeterlidir.

x-default: Varsayılan Sayfa Etiketleme

x-default değeri, hreflang sisteminin önemli ama sıkça atlanmış parçasıdır. Hiçbir dil/bölge versiyonunun kullanıcıyla eşleşmediği durumlarda gösterilecek varsayılan sayfayı belirtir.

Tipik kullanım senaryoları:

Kullanıcının dili desteklenmiyorsa dil seçim sayfasına yönlendirmek
Coğrafi hedeflenemeyen kullanıcılara genel bir İngilizce sayfa sunmak
Uluslararası hedef kitlelere varsayılan landing page göstermek

&lt;link rel="alternate" hreflang="tr" href="https://example.com/tr/" /&gt;
&lt;link rel="alternate" hreflang="de" href="https://example.com/de/" /&gt;
&lt;link rel="alternate" hreflang="en" href="https://example.com/en/" /&gt;
&lt;link rel="alternate" hreflang="x-default" href="https://example.com/" /&gt;

Yukarıdaki örnekte x-default, Türkçe, Almanca veya İngilizce dışındaki bir dil kullanan ziyaretçileri https://example.com/ adresine yönlendirir. Bu sayfa genellikle bir dil seçim ekranı ya da İngilizce ana sayfa olur.

Uyarı: x-default etiketini eklemeyi unutmak, en yaygın hreflang hatalarından biridir. Google, eşleşmeyen kullanıcı için hangi sürümü sunacağını bilemez ve rastgele bir seçim yapabilir.

Hreflang Uygulamanın 3 Yöntemi

Google hreflang etiketlerini üç farklı yerde okuyabilir: HTML <head> bölümü, HTTP başlıkları ve XML sitemap. Her üç yöntem de eş değer güçtedir; ancak farklı kullanım durumlarına uygundur.

Yöntem 1: HTML Head Etiketi

En yaygın ve önerilen yöntemdir. Sayfanın <head> bölümüne <link> etiketleri eklenir.

&lt;!DOCTYPE html&gt;
&lt;html lang="tr"&gt;
&lt;head&gt;
  &lt;meta charset="UTF-8"&gt;
  &lt;title&gt;Hreflang Örneği&lt;/title&gt;

  &lt;!-- Türkçe (Türkiye) --&gt;
  &lt;link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/" /&gt;

  &lt;!-- Almanca (Almanya) --&gt;
  &lt;link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/" /&gt;

  &lt;!-- Almanca (Avusturya) --&gt;
  &lt;link rel="alternate" hreflang="de-AT" href="https://example.com/at/produkt/" /&gt;

  &lt;!-- İngilizce (Genel) --&gt;
  &lt;link rel="alternate" hreflang="en" href="https://example.com/en/product/" /&gt;

  &lt;!-- Varsayılan --&gt;
  &lt;link rel="alternate" hreflang="x-default" href="https://example.com/en/product/" /&gt;
&lt;/head&gt;
&lt;body&gt;
  ...
&lt;/body&gt;
&lt;/html&gt;

Avantajları:

Uygulaması kolay ve görünürlüğü yüksek
Her sayfada bağımsız olarak yönetilebilir
CMS entegrasyonu genellikle hazır eklentilerle sağlanır

Dezavantajları:

Çok büyük sitelerde sayfa başına düzenleme gerektirdiğinden yönetimi güçleşebilir
JavaScript ile render edilen sayfalarda Googlebot tarafından okunmayabilir (SSR tercih edilmeli)

Yöntem 2: HTTP Header Yöntemi

Bu yöntem yalnızca HTML olmayan dosyalar için uygundur: PDF belgeler, görsel dosyalar, CSV indirmeleri. Sunucu yanıtına HTTP başlığı eklenir.

HTTP/1.1 200 OK
Content-Type: application/pdf
Link: &lt;https://example.com/tr/rehber.pdf&gt;; rel="alternate"; hreflang="tr-TR",
      &lt;https://example.com/de/leitfaden.pdf&gt;; rel="alternate"; hreflang="de-DE",
      &lt;https://example.com/en/guide.pdf&gt;; rel="alternate"; hreflang="en",
      &lt;https://example.com/en/guide.pdf&gt;; rel="alternate"; hreflang="x-default"

Apache sunucularda .htaccess üzerinden şu şekilde yapılandırılabilir:

&lt;FilesMatch "rehber\.pdf$"&gt;
  Header add Link "&lt;https://example.com/tr/rehber.pdf&gt;; rel=\"alternate\"; hreflang=\"tr-TR\""
  Header add Link "&lt;https://example.com/de/leitfaden.pdf&gt;; rel=\"alternate\"; hreflang=\"de-DE\""
&lt;/FilesMatch&gt;

Nginx için:

location ~* /rehber\.pdf$ {
    add_header Link '&lt;https://example.com/tr/rehber.pdf&gt;; rel="alternate"; hreflang="tr-TR"';
    add_header Link '&lt;https://example.com/de/leitfaden.pdf&gt;; rel="alternate"; hreflang="de-DE"';
}

Ne zaman kullanılır? HTML sayfanız dışındaki dosyalar için tek seçenektir. HTML sayfalar için ise HTML head yöntemi her zaman daha pratiktir.

Yöntem 3: XML Sitemap Yöntemi

Büyük e-ticaret siteleri veya çok sayıda sayfa içeren sitelerde tercih edilir. Tüm hreflang ilişkileri tek bir sitemap dosyasında merkezi olarak yönetilir.

Sitemap dosyasının başına xhtml namespace’i eklenmelidir:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml"&gt;

  &lt;!-- Türkçe sayfa --&gt;
  &lt;url&gt;
    &lt;loc&gt;https://example.com/tr/urun/&lt;/loc&gt;
    &lt;xhtml:link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/product/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/product/"/&gt;
  &lt;/url&gt;

  &lt;!-- Almanca sayfa --&gt;
  &lt;url&gt;
    &lt;loc&gt;https://example.com/de/produkt/&lt;/loc&gt;
    &lt;xhtml:link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/product/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/product/"/&gt;
  &lt;/url&gt;

  &lt;!-- İngilizce sayfa --&gt;
  &lt;url&gt;
    &lt;loc&gt;https://example.com/en/product/&lt;/loc&gt;
    &lt;xhtml:link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/product/"/&gt;
    &lt;xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/product/"/&gt;
  &lt;/url&gt;

&lt;/urlset&gt;

Dikkat: Sitemap yönteminde de her URL grubunun tüm alternatiflerini listelemesi zorunludur. “Biz sadece Türkçe sayfadan işaret edelim, yeter” anlayışı çalışmaz — her sayfanın kendi girişi olmalıdır.

Avantajları:

Merkezi yönetim: Binlerce sayfayı tek dosyadan düzenleyebilirsiniz
Sayfayı editlemeden güncelleme imkânı
Büyük siteler için tercih sebebi

Dezavantajları:

Sitemap bot tarafından taranmadan önce hreflang okunmaz; HTML head yöntemiyle kıyaslandığında daha yavaş keşfedilebilir
Sitemap boyutu büyüdükçe yönetimi karmaşıklaşır (50.000 URL sınırına dikkat)

Çift Yönlü Referans Zorunluluğu

Hreflang’ın en kritik teknik kuralı çift yönlü (karşılıklı) referans zorunluluğudur. Sayfa A, Sayfa B’yi işaret ediyorsa Sayfa B de mutlaka Sayfa A’yı işaret etmelidir. Bu kural, tüm dil alternatifleri arasında geçerlidir.

Neden Çift Yönlü Referans Gereklidir?

Google, hreflang ilişkilerini güvenilir bulmak için karşılıklı doğrulama yapar. A sayfası B’yi gösteriyor ama B, A’yı göstermiyorsa Google bu ilişkiyi görmezden gelebilir ya da uyarı oluşabilir.

Doğru Çift Yönlü Referans Örneği

Türkçe sayfa (/tr/urun/):

&lt;link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/" /&gt;
&lt;link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/" /&gt;
&lt;link rel="alternate" hreflang="en" href="https://example.com/en/product/" /&gt;
&lt;link rel="alternate" hreflang="x-default" href="https://example.com/en/product/" /&gt;

Almanca sayfa (/de/produkt/) — aynı etiket setini içermeli:

&lt;link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/" /&gt;
&lt;link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/" /&gt;
&lt;link rel="alternate" hreflang="en" href="https://example.com/en/product/" /&gt;
&lt;link rel="alternate" hreflang="x-default" href="https://example.com/en/product/" /&gt;

İngilizce sayfa (/en/product/) — aynı etiket seti:

&lt;link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/" /&gt;
&lt;link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/" /&gt;
&lt;link rel="alternate" hreflang="en" href="https://example.com/en/product/" /&gt;
&lt;link rel="alternate" hreflang="x-default" href="https://example.com/en/product/" /&gt;

Görüldüğü gibi her üç sayfada da aynı etiket seti bulunmaktadır. Yalnızca URL değerleri sabittir; her sayfa kendisini de dahil ederek tüm alternatifleri listeler.

Kendine Referans (Self-Referencing) Zorunlu mu?

Evet. Kendi sayfasının da hreflang listesinde olması gerekir. Yukarıdaki örneklerde /tr/urun/ sayfası hreflang="tr-TR" olarak kendisini de listeler. Bu, Google’ın belgelediği standart uygulamadır.

Site Yapı Seçenekleri: ccTLD, Subdomain, Subdirectory

Uluslararası SEO stratejisini kurarken alınması gereken en önemli kararlardan biri site yapısıdır. Hreflang bu kararı etkilemez — her üç yapıda da hreflang kullanabilirsiniz — ancak yapının SEO ve operasyonel sonuçları farklıdır.

ccTLD (Country Code Top-Level Domain)

Her ülkeye özgü alan adı kullanılır: .tr, .de, .fr, .co.uk gibi.

Örnekler:

https://example.com.tr/ → Türkiye
https://example.de/ → Almanya
https://example.fr/ → Fransa

Avantajları:

En güçlü coğrafi hedefleme sinyali
Yerel kullanıcılar ve arama motorları tarafından güvenilir bulunur
Google Search Console’da ülke bazlı hedefleme ayarına gerek yok

Dezavantajları:

Her ccTLD ayrı bir domain otoritesi biriktirir; backlink profilleri birbirini desteklemez
Yönetim maliyeti yüksek: her domain için ayrı barındırma, SSL, yönetim
Bazı ülkelerin ccTLD’leri yalnızca o ülkedeki kuruluşlara verilebilir

Subdomain

https://tr.example.com/, https://de.example.com/ gibi.

Avantajları:

Ana domain’den bağımsız olarak farklı sunucularda barındırılabilir
ccTLD’ye göre kurulumu daha kolay
Google Search Console’da alt domain bazlı coğrafi hedefleme yapılabilir

Dezavantajları:

Google subdomainleri bazen ayrı site olarak değerlendirdiğinden link gücü akışı tam değil
Ana domain otoritesinden en düşük yararlanan yapı

Subdirectory (Klasör Yapısı)

https://example.com/tr/, https://example.com/de/ gibi.

Avantajları:

Tüm dil sürümleri tek domain altında olduğundan backlink gücü konsolide olur
Yönetim ve teknik yapı en basit seçenek
CMS entegrasyonu (WordPress, Shopify, Astro vb.) en kolay bu yapıda

Dezavantajları:

ccTLD kadar güçlü coğrafi sinyal vermez
Büyük sitelerde URL yapısı karmaşıklaşabilir

Tavsiye: Başlangıç aşamasındaki çok dilli siteler için subdirectory en pratik ve SEO dostu seçenektir. Köklü markalar ve cidli kaynaklara sahip işletmeler için ccTLD daha güçlü sinyal üretir.

Yaygın Hreflang Hataları ve Çözümleri

Hreflang etiketleri, doğru uygulanmadığında sıkıca uyarılar üretir ve sıralamayı olumsuz etkiler. İşte en sık karşılaşılan hatalar:

Hata 1: x-default Etiketini Atlama

Problem: x-default etiketi hiçbir dille eşleşmeyen kullanıcılar için zorunludur. Bu etiket eksik olduğunda Google, belirsiz kullanıcılar için hangi sayfayı sunacağına kendisi karar verir.

Çözüm: Her hreflang etiket setine mutlaka bir x-default satırı ekleyin.

&lt;!-- Eksik - HATALI --&gt;
&lt;link rel="alternate" hreflang="tr" href="https://example.com/tr/" /&gt;
&lt;link rel="alternate" hreflang="de" href="https://example.com/de/" /&gt;

&lt;!-- Doğru --&gt;
&lt;link rel="alternate" hreflang="tr" href="https://example.com/tr/" /&gt;
&lt;link rel="alternate" hreflang="de" href="https://example.com/de/" /&gt;
&lt;link rel="alternate" hreflang="x-default" href="https://example.com/" /&gt;

Hata 2: Tek Yönlü Referans

Problem: A sayfası B’yi işaret ediyor, ancak B sayfasında hreflang etiketleri hiç yok ya da A’yı işaret etmiyor.

Etki: Google bu tek taraflı ilişkiyi geçersiz sayar. Search Console’da “Hreflang kümelerindeki sayfalardan bazılarında geri dönüş etiketleri eksik” uyarısı çıkar.

Çözüm: Her sayfanın tüm alternatifleri — kendisi dahil — listeleyen eksiksiz hreflang seti içerdiğinden emin olun.

Hata 3: Yanlış veya Desteklenmeyen Dil Kodu

Problem: hreflang="turkish" veya hreflang="tr_TR" gibi geçersiz değerler kullanmak.

Hatalı	Doğru
`turkish`	`tr`
`tr_TR`	`tr-TR`
`german`	`de`
`de_DE`	`de-DE`
`ENG`	`en`
`zh-simplified`	`zh-Hans`

Dil kodları ISO 639-1 (küçük harf), bölge kodları ISO 3166-1 Alpha-2 (büyük harf) olmalı; ikisi tire - ile ayrılmalıdır.

Hata 4: Yönlendirilen URL’leri Hreflang’a Eklemek

Problem: 301 yönlendirmesi yapılan bir URL’yi hreflang etiketi içinde kullanmak. Google yönlendirmeyi takip eder ama bu gecikme ve sinyal kaybına yol açar.

Çözüm: Hreflang etiketlerinde her zaman kanonik (final) URL’leri kullanın. HTTPS, www veya www-sız fark gözetmeksizin gerçek hedef URL hangisiyse onu yazın.

Hata 5: Hreflang ile Canonical Çakışması

Problem: Bir sayfa canonical olarak başka bir URL’yi işaret ederken, hreflang etiketleri kendi URL’sini kullanıyorsa çelişki yaşanır.

&lt;!-- Canonical başka URL'yi işaret ediyor --&gt;
&lt;link rel="canonical" href="https://example.com/en/product/" /&gt;

&lt;!-- Ama hreflang bu sayfanın URL'sini kullanıyor --&gt;
&lt;link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/" /&gt;

Çözüm: Canonical URL ile hreflang etiketlerindeki URL’lerin uyumlu olduğundan emin olun. Her sayfanın canonical’ı kendini göstermeli ve hreflang etiketleri bu kanonik URL’leri kullanmalıdır.

Hata 6: Dil Kodunu Büyük Harfle Yazmak

Problem: hreflang="TR" veya hreflang="DE-DE" gibi yazımlar.

Doğru format: dil kodu daima küçük harf, ülke kodu daima büyük harf.

&lt;!-- Hatalı --&gt;
&lt;link rel="alternate" hreflang="TR-TR" href="..." /&gt;

&lt;!-- Doğru --&gt;
&lt;link rel="alternate" hreflang="tr-TR" href="..." /&gt;

Hata 7: robots.txt ile Engellenen Sayfaları Hreflang’a Dahil Etmek

Problem: robots.txt ile Googlebot’a kapatılmış sayfaları hreflang listesine eklemek. Google o sayfayı tarayamadığından hreflang etiketlerini okuyamaz.

Çözüm: Hreflang listesindeki tüm URL’lerin indekslenebilir durumda olduğunu, robots.txt ve noindex etiketlerinin bu sayfaları engellemediğini doğrulayın.

Çince İçin Özel Durum: zh-Hans ve zh-Hant

Çin Halk Cumhuriyeti (Basitleştirilmiş Çince) ve Tayvan/Hong Kong (Geleneksel Çince) için özel dil etiketleri kullanılır:

&lt;!-- Basitleştirilmiş Çince (Çin) --&gt;
&lt;link rel="alternate" hreflang="zh-Hans" href="https://example.com/zh-cn/" /&gt;

&lt;!-- Geleneksel Çince (Tayvan) --&gt;
&lt;link rel="alternate" hreflang="zh-Hant" href="https://example.com/zh-tw/" /&gt;

&lt;!-- Geleneksel Çince (Hong Kong) --&gt;
&lt;link rel="alternate" hreflang="zh-Hant-HK" href="https://example.com/hk/" /&gt;

zh-CN veya zh-TW gibi değerler de Google tarafından desteklense de resmi öneri zh-Hans ve zh-Hant biçimidir.

İngilizce’nin Birden Fazla Bölge Versiyonu

İngilizce konuşan birden fazla ülkeye hitap ediyorsanız bölge kodu eklemek gerekir:

&lt;link rel="alternate" hreflang="en-US" href="https://example.com/en-us/" /&gt;
&lt;link rel="alternate" hreflang="en-GB" href="https://example.com/en-gb/" /&gt;
&lt;link rel="alternate" hreflang="en-AU" href="https://example.com/en-au/" /&gt;
&lt;link rel="alternate" hreflang="en-CA" href="https://example.com/en-ca/" /&gt;
&lt;link rel="alternate" hreflang="x-default" href="https://example.com/en-us/" /&gt;

Bu yapı özellikle uluslararası e-ticaret siteleri için kritiktir: ABD’deki kullanıcıya USD fiyatlar, İngiltere’dekine GBP fiyatlar gösterilebilir.

Hreflang ve JavaScript Render: Dikkat Edilmesi Gerekenler

Problem: React, Vue veya Next.js gibi istemci tarafı render kullanan uygulamalarda hreflang etiketleri JavaScript ile enjekte ediliyorsa Googlebot bu etiketleri her zaman okuyamayabilir.

Çözüm önerileri:

Server-Side Rendering (SSR) kullanın: Next.js getServerSideProps veya Astro gibi SSR/SSG çerçeveleri hreflang etiketlerini HTML içine render eder.
Dynamic Rendering: Googlebot’a statik HTML, kullanıcıya dinamik içerik sunun (ancak bu yöntem karmaşık ve bakım maliyetlidir).
Prerendering: Cloudflare Workers veya benzer edge çözümleriyle Googlebot için önceden render edilmiş HTML döndürün.

En güvenli seçenek: hreflang etiketleri sunucu tarafından üretilen HTML içinde, <head> bölümünde hazır bulunsun.

Google Search Console’da Hreflang Sorunlarını Takip Etmek

Google Search Console, hreflang sorunlarını “Uluslararası Hedefleme” raporu altında raporlar. Bu bölümde iki sekme bulunur:

Dil Sekmesi

Sahip olduğunuz dil sürümlerini listeler
Hatalı dil etiketlerini ve eksik geri referansları gösterir
Uyarı: “Hreflang kümesinde geri dönüş etiketi eksik”

Ülke Sekmesi

Search Console mülkünüz subdomain veya subdirectory ise coğrafi hedeflemeyi burada düzenleyebilirsiniz
ccTLD kullanıyorsanız bu ayar zaten otomatiktir

İzlenecek temel metrikler:

Sorun	Olası Neden	Çözüm
Geri dönüş etiketi eksik	Tek yönlü referans	Tüm sayfalara çift yönlü etiket ekle
Geçersiz hreflang değeri	Yanlış dil/bölge kodu	ISO kodlarını kontrol et
Kanoniklere işaret edilmiyor	URL eşleşmezliği	Canonical ve hreflang URL’lerini hizala
Robots tarafından engellendi	robots.txt veya noindex	Sayfaların erişilebilir olduğunu doğrula

Hreflang Test Araçları

Hreflang yapılandırmanızı canlıya almadan veya aldıktan sonra test etmek için çeşitli araçlar mevcuttur.

Google Search Console

En birincil kaynaktır. “Uluslararası Hedefleme” raporunu düzenli kontrol edin.

Hreflang Tag Test Tool (Onuroztr)

Kendi Hreflang Etiketi Oluşturucu aracımızı kullanarak hreflang etiketlerinizi oluşturabilir ve doğrulayabilirsiniz. Dil/bölge kodları, x-default ve çift yönlü referans kontrollerini otomatik yapar.

Screaming Frog SEO Spider

Siteyi tarar, her sayfa için hreflang etiketlerini çeker ve şu kontrolleri yapar:

Eksik x-default
Tek yönlü referanslar
Geçersiz dil kodları
Yönlendirilen URL’lerin hreflang’a dahil edilmesi

Kullanım: Configuration → Spider → Extraction → Hreflang sekmesini etkinleştirin; tarama sonucunda Hreflang sekmesinden raporu inceleyin.

Ahrefs Site Audit

Ahrefs’in site denetim aracı, hreflang hatalarını öncelik sırasına göre listeler. “Hreflang” filtresini kullanarak yalnızca hreflang ile ilgili sorunları görüntüleyebilirsiniz.

Semrush Site Audit

Semrush’un site denetimi de benzer hreflang raporlaması sunar. Özellikle büyük e-ticaret sitelerinde sayfalı görünüm içindeki hreflang çoğaltma sorunlarını tespit etmek için kullanışlıdır.

Chrome Eklentileri

SEO META in 1 CLICK: Sayfadaki tüm meta etiketleri ve hreflang değerlerini tek tıkla görüntüler
Hreflang Checker: Yalnızca hreflang etiketlerine odaklanır, çift yönlü referans doğrulaması yapar

Hreflang ile Canonical Etiketi Birlikte Kullanımı

Hreflang ve canonical etiketleri sıkça birbirine karıştırılır. Bunlar farklı amaçlara hizmet eder ve birlikte kullanılmalıdır.

Canonical: “Bu sayfanın tercih edilen (kanonik) versiyonu budur” sinyali verir. Yinelenen içerik konsolidasyonu içindir.

Hreflang: “Bu sayfanın farklı dil/bölge alternatifleri bunlardır” sinyali verir. Uluslararası hedefleme içindir.

Doğru birlikte kullanım:

&lt;!-- Bu sayfanın kanonik versiyonu kendisidir --&gt;
&lt;link rel="canonical" href="https://example.com/tr/urun/" /&gt;

&lt;!-- Ve diğer dil alternatifleri şunlardır --&gt;
&lt;link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/urun/" /&gt;
&lt;link rel="alternate" hreflang="de-DE" href="https://example.com/de/produkt/" /&gt;
&lt;link rel="alternate" hreflang="en" href="https://example.com/en/product/" /&gt;
&lt;link rel="alternate" hreflang="x-default" href="https://example.com/en/product/" /&gt;

Her sayfa, canonical etiketiyle kendisine işaret etmeli ve hreflang etiketleriyle tüm alternatifleri listelemelidir.

Büyük Sitelerde Hreflang Yönetimi

On binlerce URL içeren e-ticaret sitelerinde hreflang yönetimi özel bir dikkat gerektirir.

Sayfalandırma (Pagination) ve Hreflang

Sayfalandırılmış içeriklerde (kategori sayfaları, blog listeleri) hreflang her sayfaya eklenmelidir:

&lt;!-- /tr/kategori/?sayfa=2 --&gt;
&lt;link rel="alternate" hreflang="tr-TR" href="https://example.com/tr/kategori/?sayfa=2" /&gt;
&lt;link rel="alternate" hreflang="de-DE" href="https://example.com/de/kategorie/?seite=2" /&gt;

URL parametreleri (filtreler, sıralama) içeren sayfalar için canonical etiketini doğru ayarlamak kritiktir. Hreflang, canonical sayfaya eklenmelidir; parametreli URL’lere değil.

Dinamik Hreflang Üretimi

Büyük sitelerde hreflang etiketlerini manuel yazmak mümkün değildir. CMS veya backend sistemi şablonlar aracılığıyla otomatik üretmelidir:

Her sayfa için:
  hreflang listesi = tüm dil/bölge versiyonlarının URL'leri
  Her URL için link etiketi oluştur
  x-default ekle
  Head'e bas

WordPress’te WPML veya Polylang eklentileri bu üretimi otomatik yapar. Shopify Markets özelliği de hreflang etiketlerini otomatik yönetir.

Uluslararası SEO Stratejisi ve Hreflang

Hreflang teknik bir araç olmakla birlikte, uluslararası SEO stratejisinin bütünüyle uyumlu olmalıdır.

Yerelleştirme ile Çeviri Farkı

Hreflang etiketleri, arama motorlarına dil alternatifleri hakkında bilgi verir; ancak bu etiketlerin değer üretmesi için içeriklerin gerçekten yerelleştirilmiş olması gerekir. Makine çevirisi ile oluşturulmuş, yalnızca dil değiştirilmiş ama kültürel ve ticari açıdan uyarlanmamış sayfalar SEO değeri düşük içerik kategorisine girer.

Yerelleştirme şunları kapsar:

Para birimi ve fiyatlandırma
Yerel ödeme yöntemleri
Coğrafi referanslar ve örnekler
Yasal uyarılar ve şartlar
Yerel telefon numaraları ve adresler
Kültüre özgü görseller ve metaforlar

Ülkeye Özgü Anahtar Kelime Araştırması

Her hedef ülke için anahtar kelime araştırması ayrıca yapılmalıdır. “Ürün satın al” için Türkiye ve Almanya’da farklı anahtar kelimeler ve farklı arama hacmi dağılımları söz konusudur.

Yurtdışı SEO hizmetimiz kapsamında her hedef ülke için ayrı anahtar kelime araştırması, rekabet analizi ve içerik stratejisi sunuyoruz.

Teknik SEO Altyapısı

Hreflang’ın doğru çalışması için genel teknik SEO altyapısının sağlam olması gerekir: sayfa hızı, Core Web Vitals, mobile-first indeksleme uyumu ve güvenli bağlantı (HTTPS). Teknik SEO hizmetimiz bu altyapıyı kapsamlı biçimde değerlendirir ve iyileştirir.

Hreflang ile İlgili Sık Sorulan Sorular

Hreflang olmadan çok dilli site yapabilir miyim?

Yapabilirsiniz, ancak risklidir. Hreflang olmadan Google, dil alternatifleri arasındaki ilişkiyi anlayamaz ve yinelenen içerik olarak değerlendirebilir. Ayrıca yanlış dil sürümünü kullanıcıya gösterebilir; bu da hemen çıkma oranını artırır. Ciddi bir çok dilli site için hreflang zorunludur.

Hreflang sıralamayı doğrudan etkiler mi?

Hreflang doğrudan bir sıralama faktörü değildir; ancak kullanıcıya doğru dil sürümünü sunduğunda kullanıcı sinyalleri (hemen çıkma oranı, sayfada geçirilen süre, dönüşüm) iyileşir ve bu dolaylı olarak sıralamayı olumlu etkiler. Ayrıca yinelenen içerik sorunlarını önleyerek olumsuz sinyalleri bertaraf eder.

Tüm sayfalarıma hreflang eklemek zorunda mıyım?

Yalnızca birden fazla dil veya bölge versiyonu olan sayfalara eklemek gerekir. Yalnızca tek dilde mevcut olan, politika sayfaları veya teknik dokümantasyon gibi içerikler için hreflang zorunlu değildir. Ancak ana içerik sayfalarınızın tamamı çok dilli ise, hepsi etiketlenmelidir.

Hreflang ne kadar sürede etkisini gösterir?

Google’ın hreflang etiketlerini tarayıp işlemesi genellikle birkaç günden birkaç haftaya kadar sürebilir. Büyük sitelerde bu süre daha uzun olabilir. Search Console’da “Uluslararası Hedefleme” raporunda hatalar temizlenmeye başladığında etiketlerin işlendiğini anlayabilirsiniz.

Hreflang ve 301 yönlendirme birlikte kullanılabilir mi?

Kullanılmamalıdır. Hreflang listesindeki URL’leri 301 yönlendirmesi yapıyorsanız, yönlendirmenin hedefi olan URL’yi kullanmalısınız. Yönlendirme kaynağını listelemek hem sinyali zayıflatır hem de tarama bütçesini israf eder.

Hreflang ile Sitemap Bölme Stratejisi

Çok büyük sitelerde tüm hreflang bilgilerini tek bir sitemap dosyasına sıkıştırmak hem dosya boyutunu şişirir hem de bakımı zorlaştırır. Bunun yerine dile veya bölgeye göre bölünmüş sitemap dosyaları oluşturup bir sitemap index üzerinden birleştirebilirsiniz.

Sitemap index dosyası:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"&gt;
  &lt;sitemap&gt;
    &lt;loc&gt;https://example.com/sitemap-tr.xml&lt;/loc&gt;
    &lt;lastmod&gt;2026-07-13&lt;/lastmod&gt;
  &lt;/sitemap&gt;
  &lt;sitemap&gt;
    &lt;loc&gt;https://example.com/sitemap-de.xml&lt;/loc&gt;
    &lt;lastmod&gt;2026-07-13&lt;/lastmod&gt;
  &lt;/sitemap&gt;
  &lt;sitemap&gt;
    &lt;loc&gt;https://example.com/sitemap-en.xml&lt;/loc&gt;
    &lt;lastmod&gt;2026-07-13&lt;/lastmod&gt;
  &lt;/sitemap&gt;
&lt;/sitemapindex&gt;

Her dil sitemapı kendi URL’lerini içerir ve her URL’de tüm hreflang alternatifleri listelenir. Bu yapı sayesinde Googlebot her dil bloğunu bağımsız olarak tarayabilir ve büyük sitemap dosyalarının getirdiği tarama bütçesi yükü dağıtılır.

Sitemap Dosyasını Google Search Console’a Göndermek

Hreflang içeren sitemap dosyanızı Google Search Console üzerinden göndermek, Google’ın bu etiketleri hızlıca keşfetmesini sağlar:

Search Console’da ilgili mülkü seçin
Sol menüden “Sitemaps” bölümüne gidin
Sitemap URL’sini (örn. https://example.com/sitemap.xml) girin ve gönderin
İşleme durumunu birkaç gün içinde kontrol edin

Sitemap başarıyla işlendiğinde “Başarılı” durumu görünür ve keşfedilen URL sayısı listelenir. Hata oluşursa hata detaylarına tıklayarak nedenini öğrenebilirsiniz.

Hreflang Uygulama Kontrol Listesi

Yayına geçmeden önce aşağıdaki kontrolleri yapın:

Temel Kontroller:

Tüm dil/bölge versiyonlarına doğru hreflang değerleri eklendi mi?
x-default etiketi her sayfada mevcut mu?
Tüm sayfalar çift yönlü referans içeriyor mu?
Her sayfa kendisine işaret ediyor mu (self-referencing)?

Teknik Kontroller:

Kullanılan tüm dil kodları ISO 639-1 standardına uygun mu?
Bölge kodları ISO 3166-1 Alpha-2 standardına uygun mu?
Dil kodu küçük, bölge kodu büyük harf mi?
Hreflang listesindeki URL’ler canonical URL’lerle eşleşiyor mu?
Hreflang listesindeki URL’ler robots.txt veya noindex tarafından engellenmemiş mi?
JavaScript render kullanılıyorsa etiketler SSR ile üretiliyor mu?

Doğrulama:

Google Search Console’da Uluslararası Hedefleme raporu kontrol edildi mi?
Screaming Frog veya benzeri araçla site taraması yapıldı mı?
Her sayfa için hreflang etiketi tarayıcıda görüntülenerek doğrulandı mı?

Sonuç

Hreflang, çok dilli ve çok bölgeli web sitelerinin uluslararası arama sonuçlarında doğru kullanıcıya ulaşmasını sağlayan kritik bir teknik SEO bileşenidir. Doğru uygulandığında kullanıcı deneyimini iyileştirir, yinelenen içerik riskini azaltır ve organik trafiğin kalitesini artırır.

Başarılı bir hreflang uygulaması için şu üç temel ilkeyi aklınızda tutun: çift yönlü referans (her sayfa tüm alternatifleri listeler), x-default (eşleşmeyen kullanıcılar için varsayılan sayfa) ve doğru ISO kodları (dil küçük harf, ülke büyük harf).

Karmaşık çok dilli site yapınız için destek almak veya hreflang uygulamanızı profesyonel olarak denetletmek istiyorsanız Teknik SEO hizmetimize göz atabilir ya da Yurtdışı SEO sayfamızdan uluslararası SEO stratejinizi planlamak için bizimle iletişime geçebilirsiniz.

Hreflang Nedir ve Ne İşe Yarar?

Hreflang’ın Temel Faydaları

Dil Kodu mu, Bölge Kodu mu? Fark Nedir?

Dil Kodları (ISO 639-1)

Bölge Kodları (ISO 3166-1 Alpha-2)

Yalnızca Dil mi, Dil + Bölge mi?

x-default: Varsayılan Sayfa Etiketleme

Hreflang Uygulamanın 3 Yöntemi

Yöntem 1: HTML Head Etiketi

Yöntem 2: HTTP Header Yöntemi

Yöntem 3: XML Sitemap Yöntemi

Çift Yönlü Referans Zorunluluğu

Neden Çift Yönlü Referans Gereklidir?

Doğru Çift Yönlü Referans Örneği

Kendine Referans (Self-Referencing) Zorunlu mu?

Site Yapı Seçenekleri: ccTLD, Subdomain, Subdirectory

ccTLD (Country Code Top-Level Domain)

Subdomain

Subdirectory (Klasör Yapısı)

Yaygın Hreflang Hataları ve Çözümleri

Hata 1: x-default Etiketini Atlama

Hata 2: Tek Yönlü Referans

Hata 3: Yanlış veya Desteklenmeyen Dil Kodu

Hata 4: Yönlendirilen URL’leri Hreflang’a Eklemek

Hata 5: Hreflang ile Canonical Çakışması

Hata 6: Dil Kodunu Büyük Harfle Yazmak

Hata 7: robots.txt ile Engellenen Sayfaları Hreflang’a Dahil Etmek

Çince İçin Özel Durum: zh-Hans ve zh-Hant

İngilizce’nin Birden Fazla Bölge Versiyonu

Hreflang ve JavaScript Render: Dikkat Edilmesi Gerekenler

Google Search Console’da Hreflang Sorunlarını Takip Etmek

Dil Sekmesi

Ülke Sekmesi

Hreflang Test Araçları

Google Search Console

Hreflang Tag Test Tool (Onuroztr)

Screaming Frog SEO Spider

Ahrefs Site Audit

Semrush Site Audit

Chrome Eklentileri

Hreflang ile Canonical Etiketi Birlikte Kullanımı

Büyük Sitelerde Hreflang Yönetimi

Sayfalandırma (Pagination) ve Hreflang

Filtreleme ve Faceted Navigation

Dinamik Hreflang Üretimi

Uluslararası SEO Stratejisi ve Hreflang

Yerelleştirme ile Çeviri Farkı

Ülkeye Özgü Anahtar Kelime Araştırması

Teknik SEO Altyapısı

Hreflang ile İlgili Sık Sorulan Sorular

Hreflang olmadan çok dilli site yapabilir miyim?

Hreflang sıralamayı doğrudan etkiler mi?

Tüm sayfalarıma hreflang eklemek zorunda mıyım?

Hreflang ne kadar sürede etkisini gösterir?

Hreflang ve 301 yönlendirme birlikte kullanılabilir mi?

Hreflang ile Sitemap Bölme Stratejisi

Sitemap Dosyasını Google Search Console’a Göndermek

Hreflang Uygulama Kontrol Listesi

Sonuç