Kısa cevap
React SEO, React ile geliştirilen sitelerin arama motorlarınca taranıp dizine eklenebilmesi için render yönteminin, meta etiketlerinin, bağlantıların ve durum kodlarının doğru kurulmasıdır. Google JavaScript’i çalıştırabilir, ancak render ayrı bir kuyrukta yapılır ve her bot JavaScript çalıştırmaz. En güvenli yol içeriğin, başlığın ve yapılandırılmış verinin sunucuda HTML olarak üretilmesidir; Next.js bunu sunucu tarafı render ve statik üretimle sağlar.
React ile yapılan siteler SEO’da neden ayrı dikkat ister?
React ile yapılan siteler SEO’da ayrı dikkat ister, çünkü varsayılan kurulumda içerik sunucuda değil, ziyaretçinin tarayıcısında JavaScript çalıştıktan sonra oluşur. İstemci tarafında render eden tek sayfa uygulamasında (single page application, SPA) sunucunun gönderdiği ilk HTML çoğu zaman boş bir kabuktur; başlık, metin ve bağlantılar betik çalışınca belirir. Arama motoru bu ikinci adımı geciktirir ya da tamamlayamazsa sayfa dizine eksik girer.
Google bu yapıyı uygulama kabuğu (app shell) modeli olarak adlandırır ve JavaScript ile çalışan sayfaları üç aşamada işlediğini belirtir:
- Tarama: Googlebot adresi kuyruktan alır, robots.txt izin veriyorsa sayfayı ister ve yanıttaki
<a href>bağlantılarını tarama kuyruğuna ekler. - Render kuyruğu: 200 durum kodu dönen sayfalar,
noindextaşımıyorsa render için sıraya alınır. Google’a göre sayfa bu kuyrukta birkaç saniye kalabilir, ama bekleme daha uzun da sürebilir; kaynak uygun olduğunda başsız (headless) Chromium sayfayı açar ve JavaScript’i çalıştırır. - Dizine ekleme: Google işlenmiş HTML’deki bağlantıları yeniden kuyruğa ekler ve sayfayı bu işlenmiş HTML üzerinden dizine alır.
Google Arama JavaScript’i Chromium’un güncel tutulan bir sürümüyle çalıştırır; yani React tek başına bir engel değildir. Aynı belge yine de sunucu tarafında render ya da ön render’ın hâlâ iyi bir fikir olduğunu söyler: site kullanıcılar ve tarayıcılar için hızlanır, üstelik her bot JavaScript çalıştıramaz. Sosyal ağ önizleme botları ve yapay zekâ tarayıcıları için de sunucuda basılan HTML en güvenli yoldur.
Bu yüzden React SEO ayrı bir kural seti değildir; arama motoru optimizasyonunun temelleri aynen geçerlidir. Değişen, tarama ile dizine ekleme arasına bir render adımının girmesidir. Tarama ve dizine eklemenin genel kontrollerini teknik SEO rehberimizde anlattık.
CSR, SSR, SSG, ISR ve Server Components SEO açısından nasıl karşılaştırılır?
SEO açısından en güvenli seçenekler, içeriği sunucuda ya da derleme sırasında HTML’e çeviren yöntemlerdir: statik üretim (SSG), artımlı statik yenileme (ISR), sunucu tarafı render (SSR) ve React Server Components. İstemci tarafı render (CSR) ile üretilen sayfa da dizine girebilir, ama içeriğin görünmesi render kuyruğuna ve botun JavaScript çalıştırmasına bağlı kalır. Seçim site genelinde değil, sayfa türüne göre yapılır.
| Yöntem | HTML nerede ve ne zaman oluşur | SEO açısından | Uygun olduğu yer |
|---|---|---|---|
| CSR (istemci tarafı render) | Tarayıcıda, JavaScript çalıştıktan sonra | İçerik render aşamasına bağlıdır; JavaScript çalıştırmayan botlar boş kabuk görür | Oturum arkasındaki paneller, dizine girmesi gerekmeyen ekranlar |
| SSR (sunucu tarafı render) | Sunucuda, her istekte | İçerik ilk yanıtta HTML olarak gelir; sunucu yanıt süresi (TTFB) uzayabilir | Sık değişen ya da isteğe göre farklılaşan sayfalar |
| SSG (statik üretim) | Derleme sırasında, her adres için önceden | İçerik hazır HTML’dir; TTFB tutarlı biçimde hızlıdır | Blog, belge, kurumsal ve hizmet sayfaları |
| ISR (artımlı statik yenileme) | Derlemede üretilir; belirlenen aralıkla ya da istek üzerine arka planda yenilenir | Statik sayfanın avantajı korunur, site baştan derlenmeden içerik güncellenir | Büyük kataloglar, çok sayıda içerik sayfası |
| React Server Components | Sunucuda, derlemede ya da her istekte; bileşen kodu tarayıcıya gönderilmez | İçerik ilk yüklemede görünür, istemci paketi küçülür | Next.js App Router ile kurulan içerik ağırlıklı sayfalar |
- Hydration
- Hydration, sunucuda üretilmiş HTML’e tarayıcıda çalışan betiklerle uygulama durumunun ve etkileşimin eklenmesidir.
web.dev’in render rehberi, tam hydration’a dayanan yaklaşım yerine sunucu tarafı render ya da statik render’ın değerlendirilmesini önerir. Botlara ayrı, kullanıcılara ayrı sürüm sunan dinamik render (dynamic rendering) ise bugün önerilen bir yol değildir: Google’ın belgesi onu uzun vadeli olmayan bir geçici çözüm olarak tanımlar ve yerine sunucu tarafı render, statik render ya da hydration önerir.
Hangi sayfanın hangi yöntemle üretileceği bir mimari karardır ve sonradan değiştirmek maliyetlidir. Özel yazılım projelerimizde bu kararı geliştirme başlamadan, sayfa türleri listelenirken veriyoruz: dizine girmesi gereken sayfalar statik ya da sunucu tarafı render ile, oturum arkasındaki ekranlar istemci tarafında üretilir.
React ve Next.js’te başlık ve meta etiketleri nasıl yönetilir?
Başlık ve meta etiketleri React’te üç yoldan yönetilir: React 19’un yerleşik <title> ve <meta> desteği, react-helmet-async gibi bir kitaplık ya da Next.js’in Metadata API’si. SEO açısından belirleyici olan araç değil, etiketlerin sunucudan gelen ilk HTML’de yer almasıdır. Yalnızca tarayıcıda eklenen başlığı Google ancak render aşamasında görür; JavaScript çalıştırmayan botlar ise hiç görmez.
| Yöntem | Nasıl çalışır | Dikkat edilecek nokta |
|---|---|---|
| React 19 yerleşik etiketler | Herhangi bir bileşende yazılan <title>, <meta> ve <link> etiketlerini React belgenin <head> bölümüne taşır; yalnız istemcide çalışan uygulamada, akışlı SSR’de ve Server Components’te geçerlidir | Aynı anda tek bir <title> render edilmelidir; rotaya göre değer ezme gibi ihtiyaçlarda React’in duyurusu yine bir kitaplığı işaret eder |
| react-helmet-async | react-helmet’in çatalıdır; veriyi istek başına tutabilmek için uygulama HelmetProvider ile sarılır | 3.0.0 sürümünden itibaren React sürümünü çalışma anında algılar; React 19’da etiketleri yerel öğe olarak basar ve <head> bölümüne taşımayı React’e bırakır |
| Next.js Metadata API | layout ya da page dosyasından dışa aktarılan metadata nesnesi ya da generateMetadata işlevi; ilgili <head> etiketlerini Next.js üretir | Yalnız Server Components’te desteklenir; ikisi aynı rota bölümünden birlikte dışa aktarılamaz |
Next.js’te sayfanın başlığı title, açıklaması description, kanonik adresi alternates.canonical, dizin yönergesi robots alanıyla verilir; title.template alt sayfaların başlığına ortak bir ek koyar, metadataBase göreli adresleri tam adrese çevirir. Veriye bağlı sayfalarda bu alanları generateMetadata doldurur. Next.js 15.2’den itibaren bu işlevin sonucu akışla sonradan gönderilebilir; Next.js belgelerine göre JavaScript çalıştıramayan botlarda yanıt, meta veriler <head> içine yazılana kadar bekletilir.
Kanonik etiket ve noindex için Google’ın iki uyarısı React projelerinde özellikle önemlidir. Kanonik adresi vermenin en iyi yeri HTML’dir; JavaScript ile eklenecekse ilk HTML’deki değerle çelişmemelidir. Google noindex gördüğü sayfada render’ı ve JavaScript’i atlayabildiği için, ilk HTML’e noindex koyup betikle kaldırmak beklendiği gibi çalışmayabilir.
React’te bağlantılar, hash adresler ve 404 durum kodları nasıl kurulur?
React’te sayfa geçişleri, href özniteliği taşıyan gerçek <a> öğeleriyle ve History API’ye dayanan temiz adreslerle kurulmalıdır; var olmayan adres ise gerçek bir 404 yanıtı döndürmelidir. Google bir bağlantıyı genellikle yalnızca href taşıyan bir <a> öğesiyse tarayabilir. onClick ile çalışan bir <div> kullanıcıyı yeni sayfaya götürür, ama tarayıcıya izleyeceği bir adres bırakmaz.
- Link bileşenleri: Next.js’in
next/linkbileşeni HTML<a>öğesini genişletir vehrefdeğeri zorunludur; React Router’ınLinkbileşeni de kendi belgelerinde bir<a href>sarmalayıcısı olarak tanımlanır. onClickile gezinme: Bir kartın ya da tablo satırının tamamınarouter.pushbağlamak HTML’de bağlantı bırakmaz. Tıklanabilir alan genişletilecekse içeride yine bir<a>bulunmalıdır.- Hash adresler:
/#/urunlerbiçimindeki adresler ayrı sayfa olarak dizine girmez. Google, farklı içerik yüklemek için URL parçalarının (fragment) kullanılmamasını ve istemci tarafı yönlendirmenin History API ile yapılmasını ister. - Soft 404: İstemci tarafında render eden uygulamada sunucu çoğu zaman her adrese 200 döndürür; silinmiş bir ürün “bulunamadı” metniyle birlikte 200 verirse soft 404 oluşur. Google iki çözüm sayar: sunucunun 404 döndürdüğü bir adrese JavaScript ile yönlendirmek ya da hata sayfasına JavaScript ile
noindexeklemek. - Next.js’te
notFound: İşlev, yanıt başlamadan çağrılırsa sayfa 404 döner. Akış başladıktan sonra çağrılırsa durum kodu 200 kalır; Next.js iki durumda da sayfayanoindexekler. İçeriğin var olup olmadığını akıştan önce denetlemek bu yüzden daha temiz sonuç verir. - Saklanan duruma bağlı içerik: Bot sayfaya çoğu zaman çerezsiz ve boş depolamayla gelir. Yalnızca çerezdeki ya da
localStorageiçindeki bir değere göre açılan içerik bu yüzden dizine girmeyebilir.
Adres yapısı ve gezinme kararlarının tasarım aşamasındaki karşılığını web sitesi tasarlanırken SEO kontrol listemizde ele aldık.
Next.js’te site haritası, robots.txt ve JSON-LD nasıl üretilir?
Next.js’te site haritası app/sitemap.ts, robots.txt ise app/robots.ts dosyasıyla koddan üretilir; JSON-LD de sayfa bileşeninin içinde, sunucuda basılan bir <script> etiketiyle verilir. Üçünün ortak yararı, sayfalarla aynı veri kaynağından beslenmeleri ve elle güncelleme gerektirmemeleridir.
- Site haritası:
sitemap.tsdosyasının dışa aktardığı işlev,urlvelastModifiedgibi alanlar taşıyan bir adres dizisi döndürür; XML çıktısını Next.js üretir. Büyük sitelerde haritagenerateSitemapsile parçalara bölünür. Haritaya yalnız 200 dönen, kanonik ve dizine girmesi istenen adresler yazılmalıdır. - robots.txt:
robots.tsdosyasırulesvesitemapalanlarını taşıyan bir nesne döndürür. Uygulamanın JavaScript ve CSS paketlerinin bulunduğu dizinler engellenmemelidir; Google engellenen dosyalardaki JavaScript’i render etmez. - JSON-LD: Google, JavaScript ile üretilip sayfaya eklenen JSON-LD’yi işleyebildiğini belirtir. Next.js belgeleri ise yapılandırılmış verinin
layoutya dapagebileşeninde bir<script>etiketi olarak basılmasını önerir; böylece işaretleme ilk HTML’de yer alır. Aynı belge, veriJSON.stringifyile yazılırken<karakterinin kaçışlanmasını da hatırlatır. - Next.js dışındaki projeler: Site haritası ile robots.txt derleme adımında ayrı bir betikle üretilmeli, JSON-LD de mümkünse ön render edilen HTML’e yazılmalıdır.
Hangi sayfa türüne hangi şemanın uygun olduğunu yapılandırılmış veri türlerini anlattığımız rehberde bulabilirsiniz. Yayındaki bir sayfanın JSON-LD çıktısını yapısal veri testi yapan schema kontrol aracıyla okuyup eksik alanları görmek mümkündür.
Hydration, paket boyutu ve görseller sayfa hızını nasıl etkiler?
Hydration ve paket boyutu en çok etkileşim metriği INP’yi, görseller ise LCP ve CLS’yi etkiler. web.dev’e göre sunucuda render edilmiş bir sayfa yüklenmiş ve etkileşime hazır görünebilir, ama hydration tamamlanana kadar girdiye yanıt veremez; istemcide gereken JavaScript miktarı da uygulama büyüdükçe artma eğilimindedir. Çözüm, tarayıcıya daha az JavaScript göndermektir.
- Server Components: Sunucu bileşenlerinin kodu tarayıcıya gönderilmez; içeriği işlemek için kullanılan ağır kitaplıklar istemci paketine girmez. Etkileşim gerektirmeyen bölümleri sunucu bileşeni olarak bırakmak paketi küçültür.
- Kod bölme:
next/dynamicya daReact.lazyileSuspense, istemci bileşenlerinin yüklenmesini gerektiği ana erteler. Next.js’te bu bileşenler varsayılan olarak yine sunucuda ön render edilir;ssr: falseseçeneği ön render’ı kapatır. Dizine girmesi gereken içerikte bu seçenek kullanılmamalıdır. - Tembel yüklenen içerik: Google Arama sayfayla etkileşime girmez. İçerik görünür alana girdiğinde yüklenmelidir (
IntersectionObserverya da tarayıcının yerleşik tembel yüklemesi); kaydırma ya da tıklama bekleyen içerik görülmeyebilir. Sonsuz akışta her parçanın kendi kalıcı adresi olmalıdır. - Görseller:
next/imagebileşeni<img>öğesini genişletir;widthveheightdeğerleri tarayıcının görsele yer ayırmasını sağlayarak düzen kaymasını önler,altise zorunludur. Görseller varsayılan olarak tembel yüklenir; sayfanın ana görselindeloadingdeğerieagerya dafetchPrioritydeğerihighverilmelidir. Next.js 16 ilepriorityözelliği kullanımı önerilmeyen duruma alınmış, yerinepreloadgelmiştir.
Metriklerin eşiklerini ve ölçüm araçlarını Core Web Vitals yazımızda anlattık.
React sayfasının Google’da nasıl render edildiği nasıl test edilir?
React sayfasının Google’da nasıl render edildiği, Search Console’daki URL Denetimi aracı ve Zengin Sonuçlar Testi ile test edilir. Google, JavaScript ile ilgili sorunlarda bu iki araçla işlenmiş HTML’e bakılmasını önerir. Testin amacı, tarayıcıda görülen içeriğin Google’ın gördüğü HTML’de de bulunduğunu doğrulamaktır.
- Ham HTML’i okuyun. Sunucunun JavaScript çalışmadan önce gönderdiği yanıtta başlık, meta açıklama, kanonik adres, ana metin ve bağlantılar var mı? Yoksa sayfa bütünüyle render aşamasına bağlıdır.
- Dizindeki sürüme bakın. URL Denetimi’nin taranan sayfa görünümü, Google’ın aldığı HTML’i, HTTP üstbilgilerini, JavaScript konsol çıktısını ve yüklenen sayfa kaynaklarını listeler.
- Canlı test yapın. “Canlı URL’yi test et” sonucundaki test edilen sayfa görünümü, ek olarak işlenmiş sayfanın ekran görüntüsünü verir; ekran görüntüsü yalnız canlı testte bulunur.
- İşlenmiş HTML’de arayın. Sayfaya özgü bir cümleyi,
<title>değerini, kanonik etiketi ve JSON-LD bloğunu işlenmiş HTML’de arayın. Orada bulunmayan öğe dizine de girmez. - Hataları giderin. Konsoldaki JavaScript hataları, yüklenemeyen ya da robots.txt ile engellenen kaynaklar ve yanıt vermeyen API istekleri eksik içeriğin sık görülen nedenleridir.
- Şemayı doğrulayın. Zengin Sonuçlar Testi ile JSON-LD’nin işlenmiş sayfada okunduğunu ve hata vermediğini denetleyin.
- Dizini izleyin. Yayından sonra Search Console’un sayfa dizine ekleme raporunda soft 404 olarak işaretlenen ve taranıp dizine eklenmeyen React sayfalarını düzenli kontrol edin.
Bu kontrol her sürümde yinelenmelidir: bir bileşenin istemci tarafına taşınması ya da yeni bir tembel yükleme, içeriği ilk HTML’den sessizce çıkarabilir. SEO paketlerimizdeki teknik denetimde JavaScript ile işlenen sayfalar, ham HTML ile işlenmiş HTML’in şablon bazında karşılaştırılmasıyla ele alınır.
Sık sorulan sorular
React SEO uyumlu mu?
Evet, React ile SEO uyumlu site yapılabilir; belirleyici olan kitaplık değil, sayfanın nasıl render edildiğidir. Sunucu tarafı render ya da statik üretimle çıkan bir React sayfası, arama motoru açısından sıradan bir HTML sayfasıdır. Yalnızca tarayıcıda render eden kurulumda ise içeriğin, başlığın ve bağlantıların dizine girmesi ek kontrol ister.
Next.js kullanmadan React sitede SEO yapılabilir mi?
Yapılabilir, ama iş yükü artar. Sunucu tarafı render ya da ön render’ı kendiniz kurmanız, meta etiketleri için React 19’un yerleşik etiketlerini ya da bir kitaplığı kullanmanız, site haritasını ve durum kodlarını ayrıca çözmeniz gerekir. Next.js gibi bir çatı bu parçaları hazır sunduğu için içerik ağırlıklı sitelerde çoğu zaman daha az emekle aynı sonuca ulaştırır.
React Helmet hâlâ gerekli mi?
React 19 kullanan sade projelerde çoğu zaman gerekmez, çünkü başlık ve meta etiketleri doğrudan bileşenin içinde yazılabilir. Rotaya göre varsayılan değerleri ezmek gibi ihtiyaçlarda bir kitaplık işi kolaylaştırır. Next.js projelerinde ise Metadata API kullanıldığı için genellikle ayrı bir kitaplığa ihtiyaç kalmaz.
Yönetim paneli gibi oturum arkasındaki React ekranları için SEO gerekir mi?
Hayır, oturum açmadan görülemeyen ekranların dizine girmesi beklenmez; bu ekranlarda istemci tarafı render sorun oluşturmaz. Dikkat edilecek nokta, panel adreslerinin site haritasına yazılmaması ve iç ekranların arama sonuçlarında görünmemesidir. SEO çalışması herkese açık tanıtım, ürün ve içerik sayfalarında yoğunlaşır.
React uygulamasını Next.js’e taşımak sıralamayı etkiler mi?
Adresler, başlıklar ve içerik aynı kalırsa geçiş genellikle sıralama kaybına yol açmaz; içerik ilk HTML’e taşındığı için dizine ekleme çoğu zaman kolaylaşır. Risk adreslerin değişmesinden doğar. Hash’li adreslerden temiz adreslere geçilirken hash bölümü sunucuya ulaşmadığı için yönlendirmenin istemci tarafında kurulması gerekir.
Kaynaklar
- Google Search Central – Understand JavaScript SEO Basics
- Google Search Central – Dynamic Rendering as a Workaround
- Google Search Central – Fix Lazy-Loaded Website Content
- web.dev – Rendering on the Web
- React – React v19 (Support for Document Metadata)
- Next.js – generateMetadata (Metadata API)
Bu yazıyı en son tarihinde gözden geçirdik.



