2026-10-28 · 11 min
Cara Pasang Hreflang dan Sitemap XML untuk Situs Dwibahasa Indonesia–Inggris
Hari ini, 28 Oktober, kita memperingati Sumpah Pemuda. Ikrar ketiga dari Kongres Pemuda II tahun 1928 berbunyi menjunjung bahasa persatuan, bahasa Indonesia. Hampir seratus tahun kemudian, saya sering menemukan situs bisnis lokal di Tangerang yang niatnya menjunjung Bahasa Indonesia, tetapi di hasil pencarian Google yang tampil justru versi Inggrisnya, atau dua versi saling berebut posisi untuk kata kunci yang sama. Penyebabnya hampir selalu sama: cara pasang hreflang yang setengah jadi, sitemap yang tidak tahu ada dua bahasa, dan tag canonical yang diam-diam membatalkan semuanya.
Saya terbiasa menilai tool dan setup SEO dari data, bukan dari kesan. Jadi tulisan ini saya susun seperti audit: aturan yang wajib dipenuhi, kode yang membangkitkan tag hreflang dan sitemap dari satu sumber, skrip untuk memeriksa hasil build, lalu cara membaca laporan Google Search Console (GSC) untuk memastikan versi bahasa yang benar memang yang diindeks dan ditampilkan.
Contoh kodenya memakai Astro, tetapi intinya adalah satu modul TypeScript biasa yang bisa Anda pakai di backend Node mana pun.
Kenapa Google bisa “salah bahasa” di situs dwibahasa
Situs dwibahasa yang umum di bisnis lokal berbentuk seperti ini: halaman utama Bahasa Indonesia di root, versi Inggris di /en/, dan isi kedua versi mirip karena memang terjemahan. Dari sudut pandang Google, ada beberapa hal yang bisa salah:
- Google mendeteksi bahasa dari konten yang terlihat, bukan dari atribut
langdi tag<html>. Kalau versi Inggris hanya menerjemahkan menu sementara isinya masih Bahasa Indonesia, Google bisa menganggap dua halaman itu duplikat. - Tanpa hreflang, Google tidak tahu dua URL itu pasangan. Keduanya diperlakukan sebagai halaman terpisah yang kebetulan mirip, dan bisa jadi hanya satu yang dipilih untuk diindeks.
- Redirect otomatis berdasarkan IP atau bahasa browser bisa menyembunyikan salah satu versi dari crawler. Googlebot umumnya merayapi dari alamat IP Amerika Serikat, jadi kalau server Anda otomatis melempar pengunjung “luar negeri” ke
/en/, versi Indonesia bisa jarang terlihat oleh crawler. Lebih aman tampilkan banner saran bahasa yang bisa ditutup, bukan redirect paksa.
Hreflang menyelesaikan poin kedua. Ia bukan sinyal ranking. Ia adalah anotasi yang memberi tahu Google: “URL-URL ini adalah halaman yang sama dalam bahasa berbeda, tampilkan yang paling cocok untuk penggunanya.”
Aturan dasar cara pasang hreflang yang benar
Sebelum menulis kode, ini daftar syarat yang saya pakai sebagai kriteria audit. Setiap pelanggaran adalah alasan hreflang diabaikan.
- Kode bahasa ISO 639-1, opsional ditambah kode negara ISO 3166-1. Bahasa Indonesia adalah
id, bukanin. Inggris adalahen, atauen-GBdanen-USkalau versinya memang dibedakan per negara.en-UKtidak valid. - Self-referencing. Setiap halaman mencantumkan dirinya sendiri di daftar hreflang, bukan hanya pasangannya.
- Reciprocal atau timbal balik. Kalau halaman Indonesia menunjuk ke halaman Inggris, halaman Inggris wajib menunjuk balik. Anotasi satu arah bisa diabaikan.
- URL absolut, lengkap dengan protokol dan domain, dan persis sama dengan URL canonical. Beda trailing slash saja sudah dihitung URL lain.
- Target harus bisa diindeks: status 200, tidak
noindex, tidak diblokirrobots.txt, dan canonical-nya menunjuk ke dirinya sendiri. - Ada
x-defaultuntuk pengguna yang bahasanya tidak cocok dengan versi mana pun.
Syarat 2 sampai 4 adalah sumber hampir semua masalah yang saya temukan. Dan ketiganya gagal karena alasan yang sama: tag ditulis manual per halaman, atau dibangkitkan oleh dua kode yang berbeda untuk HTML dan sitemap.
Bahasa Indonesia sebagai bahasa utama: struktur URL
Untuk memperlakukan Bahasa Indonesia sebagai bahasa utama, saya menyarankan struktur paling sederhana:
https://tokokopi.example/ -> Indonesia (bahasa utama, tanpa prefix)
https://tokokopi.example/layanan/
https://tokokopi.example/en/ -> Inggris
https://tokokopi.example/en/services/
Bahasa utama tanpa prefix, bahasa kedua di subfolder. Satu domain berarti satu properti GSC untuk dipantau, dan Anda tetap bisa memfilter data per bahasa dengan filter URL. Slug boleh diterjemahkan (/layanan/ dan /en/services/), dan justru di situ banyak solusi otomatis gagal, karena mereka hanya bisa memasangkan URL yang path-nya identik setelah prefix bahasa.
Domain tokokopi.example di seluruh artikel ini adalah placeholder. Ganti dengan domain Anda.
Satu sumber kebenaran: peta rute di backend
Kuncinya adalah satu modul yang tahu pasangan setiap halaman. Tag HTML, canonical, dan sitemap semuanya membaca dari sini, sehingga mustahil ketiganya tidak konsisten.
// src/lib/i18n-alternates.ts
export const SITE = 'https://tokokopi.example';
export const LANGS = ['id', 'en'] as const;
export type Lang = (typeof LANGS)[number];
// Nilai atribut hreflang per bahasa. Bahasa Indonesia = 'id', bukan 'in'.
export const HREFLANG: Record<Lang, string> = { id: 'id', en: 'en' };
// Versi yang dipakai sebagai x-default.
export const X_DEFAULT_LANG: Lang = 'id';
// Satu entri = satu halaman yang sama dalam beberapa bahasa.
// Path ditulis dengan trailing slash, sama persis dengan URL canonical.
export const ROUTES: Record<string, Partial<Record<Lang, string>>> = {
beranda: { id: '/', en: '/en/' },
layanan: { id: '/layanan/', en: '/en/services/' },
kontak: { id: '/kontak/', en: '/en/contact/' },
// Halaman yang hanya ada dalam satu bahasa tidak diberi hreflang.
'promo-tangerang': { id: '/promo-tangerang/' },
};
export const absolute = (path: string): string => new URL(path, SITE).href;
export type Alternate = { hreflang: string; href: string };
export function alternatesFor(key: string): Alternate[] {
const group = ROUTES[key];
if (!group) return [];
const alternates: Alternate[] = [];
for (const lang of LANGS) {
const path = group[lang];
if (path) alternates.push({ hreflang: HREFLANG[lang], href: absolute(path) });
}
// Hreflang hanya berarti kalau ada minimal dua versi bahasa.
if (alternates.length < 2) return [];
const fallbackPath = group[X_DEFAULT_LANG];
alternates.push({
hreflang: 'x-default',
href: fallbackPath ? absolute(fallbackPath) : alternates[0].href,
});
return alternates;
}
export function canonicalFor(key: string, lang: Lang): string | undefined {
const path = ROUTES[key]?.[lang];
return path ? absolute(path) : undefined;
}
Perhatikan dua keputusan desain. Pertama, daftar hreflang yang sama dipakai oleh semua versi dalam satu grup, sehingga self-reference dan timbal balik terjadi otomatis. Kedua, canonical juga diambil dari peta yang sama, jadi URL canonical dan URL di hreflang tidak mungkin beda trailing slash.
Untuk situs yang halamannya berasal dari CMS atau database, peta ROUTES tinggal Anda bangun dari data: setiap artikel menyimpan lang dan sebuah translationKey yang sama untuk semua terjemahannya, lalu dikelompokkan berdasarkan kunci itu.
Hreflang Astro: tag di dalam head
Di Astro, buat satu komponen untuk semua tag SEO yang berhubungan dengan bahasa.
---
// src/components/SeoHead.astro
import { alternatesFor, canonicalFor, type Lang } from '../lib/i18n-alternates';
interface Props {
routeKey: string;
lang: Lang;
title: string;
}
const { routeKey, lang, title } = Astro.props;
const canonical = canonicalFor(routeKey, lang);
const alternates = alternatesFor(routeKey);
---
<title>{title}</title>
{canonical && <link rel="canonical" href={canonical} />}
{alternates.map((a) => <link rel="alternate" hreflang={a.hreflang} href={a.href} />)}
Lalu layout dasar yang meneruskan lang ke atribut <html>. Google memang tidak memakai atribut ini untuk mendeteksi bahasa, tetapi pembaca layar dan browser memakainya, jadi tetap pasang.
---
// src/layouts/BaseLayout.astro
import SeoHead from '../components/SeoHead.astro';
import type { Lang } from '../lib/i18n-alternates';
interface Props {
routeKey: string;
lang: Lang;
title: string;
}
const { routeKey, lang, title } = Astro.props;
---
<html lang={lang}>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<SeoHead routeKey={routeKey} lang={lang} title={title} />
</head>
<body>
<slot />
</body>
</html>
Halaman versi Inggris cukup menyebut kunci rute dan bahasanya:
---
// src/pages/en/services.astro
import BaseLayout from '../../layouts/BaseLayout.astro';
---
<BaseLayout routeKey="layanan" lang="en" title="Our Services">
<h1>Our Services</h1>
</BaseLayout>
Di astro.config.mjs, set site dan buat trailing slash konsisten dengan peta rute:
// astro.config.mjs
import { defineConfig } from 'astro/config';
export default defineConfig({
site: 'https://tokokopi.example',
trailingSlash: 'always',
});
Hasil di <head> halaman /en/services/:
<link rel="canonical" href="https://tokokopi.example/en/services/">
<link rel="alternate" hreflang="id" href="https://tokokopi.example/layanan/">
<link rel="alternate" hreflang="en" href="https://tokokopi.example/en/services/">
<link rel="alternate" hreflang="x-default" href="https://tokokopi.example/layanan/">
Canonical menunjuk ke dirinya sendiri, hreflang mencantumkan kedua versi plus x-default. Itu bentuk yang kita cari.
Hreflang sitemap XML dengan xhtml:link
Sitemap adalah tempat kedua untuk anotasi yang sama, dan berguna karena Google bisa membaca seluruh pasangan bahasa tanpa harus merayapi setiap halaman dulu. Formatnya memakai namespace xhtml, dan setiap <url> mencantumkan semua versi termasuk dirinya sendiri.
Di Astro, buat endpoint statis. File bernama sitemap-i18n.xml.ts akan dibangun menjadi /sitemap-i18n.xml.
// src/pages/sitemap-i18n.xml.ts
import type { APIRoute } from 'astro';
import { LANGS, ROUTES, absolute, alternatesFor } from '../lib/i18n-alternates';
const escapeXml = (value: string): string =>
value
.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"')
.replace(/'/g, ''');
export const GET: APIRoute = () => {
const entries: string[] = [];
for (const [key, group] of Object.entries(ROUTES)) {
const links = alternatesFor(key)
.map(
(a) =>
` <xhtml:link rel="alternate" hreflang="${a.hreflang}" href="${escapeXml(a.href)}"/>`,
)
.join('\n');
for (const lang of LANGS) {
const path = group[lang];
if (!path) continue;
const linkBlock = links ? `${links}\n` : '';
entries.push(` <url>\n <loc>${escapeXml(absolute(path))}</loc>\n${linkBlock} </url>`);
}
}
const xml =
'<?xml version="1.0" encoding="UTF-8"?>\n' +
'<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ' +
'xmlns:xhtml="http://www.w3.org/1999/xhtml">\n' +
`${entries.join('\n')}\n` +
'</urlset>\n';
return new Response(xml, {
headers: { 'Content-Type': 'application/xml; charset=utf-8' },
});
};
Potongan hasilnya untuk satu grup:
<url>
<loc>https://tokokopi.example/layanan/</loc>
<xhtml:link rel="alternate" hreflang="id" href="https://tokokopi.example/layanan/"/>
<xhtml:link rel="alternate" hreflang="en" href="https://tokokopi.example/en/services/"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://tokokopi.example/layanan/"/>
</url>
<url>
<loc>https://tokokopi.example/en/services/</loc>
<xhtml:link rel="alternate" hreflang="id" href="https://tokokopi.example/layanan/"/>
<xhtml:link rel="alternate" hreflang="en" href="https://tokokopi.example/en/services/"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://tokokopi.example/layanan/"/>
</url>
Daftarkan sitemap ini di public/robots.txt:
User-agent: *
Allow: /
Sitemap: https://tokokopi.example/sitemap-i18n.xml
Bagaimana dengan @astrojs/sitemap? Integrasi resmi ini punya opsi i18n yang bisa membangkitkan xhtml:link, dan untuk situs yang path-nya identik di semua bahasa (/layanan/ dan /en/layanan/) opsi itu sudah cukup. Tetapi ia memasangkan halaman berdasarkan kesamaan path, sehingga slug yang diterjemahkan seperti /layanan/ dan /en/services/ tidak akan dianggap pasangan, dan x-default tidak ditambahkan secara bawaan. Kalau Anda memakai endpoint di atas, pilih salah satu saja: lepas integrasinya, atau pakai opsi filter miliknya untuk mengecualikan halaman yang sudah ada di sitemap-i18n.xml. Dua sitemap dengan anotasi berbeda untuk URL yang sama adalah resep inkonsistensi.
Kalau backend Anda bukan Astro, modul i18n-alternates.ts tetap bisa dipakai apa adanya. Di Express, misalnya, handler GET /sitemap-i18n.xml cukup menjalankan loop yang sama dan mengirim string XML-nya. Untuk file non-HTML seperti katalog PDF dalam dua bahasa, hreflang dikirim lewat header HTTP:
Link: <https://tokokopi.example/katalog.pdf>; rel="alternate"; hreflang="id", <https://tokokopi.example/en/catalog.pdf>; rel="alternate"; hreflang="en"
Menentukan x-default hreflang
x-default menjawab satu pertanyaan: pengguna yang bahasanya bukan Indonesia dan bukan Inggris, misalnya pencari dengan pengaturan bahasa Jepang atau Melayu, sebaiknya diberi halaman yang mana?
Ada tiga pilihan yang masuk akal:
| Pilihan x-default | Cocok untuk | Risiko |
|---|---|---|
| Versi Indonesia | Bisnis yang pelanggannya hampir semua di Indonesia, sejalan dengan Bahasa Indonesia sebagai bahasa utama | Pengunjung asing yang tidak bisa berbahasa Indonesia mendarat di halaman yang tidak mereka pahami |
| Versi Inggris | Bisnis yang mengejar pembeli luar negeri, misalnya ekspor kerajinan atau layanan untuk ekspatriat | Bahasa utama jadi terasa “nomor dua” untuk lalu lintas yang bahasanya tidak cocok |
| Halaman pemilih bahasa | Situs dengan audiens yang benar-benar terbagi | Satu klik tambahan, dan halaman pemilih biasanya tipis konten |
Saya tidak punya jawaban universal, tapi saya punya cara memutuskannya: buka laporan Performance di GSC, tab Countries, rentang 3 bulan. Kalau impresi dari luar Indonesia kecil dibandingkan dari Indonesia, X_DEFAULT_LANG = 'id' adalah pilihan yang konsisten dengan data. Kalau negara non-Indonesia menyumbang porsi yang berarti dan klik dari sana bernilai bagi bisnis, pertimbangkan 'en'. Karena nilainya ada di satu konstanta, mengubahnya nanti cukup satu baris.
Menghindari bentrokan canonical
Ini kesalahan paling mahal yang saya temukan, karena gejalanya diam: tidak ada error, hanya versi Inggris yang tidak pernah muncul.
| Pola | Akibat | Perbaikan |
|---|---|---|
Halaman /en/services/ memakai canonical ke /layanan/ | Google diminta menganggap versi Inggris sebagai duplikat versi Indonesia, sehingga hreflang ke /en/services/ kehilangan target yang bisa diindeks | Canonical setiap versi bahasa menunjuk ke dirinya sendiri |
| Canonical tanpa trailing slash, hreflang dengan trailing slash | URL di hreflang bukan URL canonical, pasangan dianggap tidak cocok | Bangkitkan keduanya dari fungsi yang sama |
Canonical memakai http:// atau domain staging | Hreflang menunjuk ke URL yang bukan versi resmi | Ambil domain dari satu konstanta SITE |
Versi Inggris diberi noindex sementara “sampai terjemahan selesai” | Hreflang menunjuk ke halaman yang tidak boleh diindeks | Jangan masukkan halaman itu ke ROUTES sampai siap |
Halaman paginasi atau parameter ?utm_ masuk sitemap | Sitemap berisi URL non-canonical | Sitemap hanya berisi URL canonical |
Aturan ringkasnya: canonical untuk memilih satu URL di antara duplikat dalam bahasa yang sama, hreflang untuk menghubungkan versi dalam bahasa berbeda. Begitu canonical dipakai untuk menyatukan dua bahasa, hreflang tidak lagi punya pasangan yang sah.
Uji sebelum deploy: skrip cek timbal balik
Sebelum menunggu Google, periksa hasil build sendiri. Skrip Node berikut membaca sitemap hasil astro build dan melaporkan URL yang tidak punya self-reference, tidak punya x-default, menunjuk ke URL yang tidak ada di sitemap, atau tidak ditunjuk balik oleh pasangannya.
// scripts/cek-hreflang.mjs
import { readFileSync } from 'node:fs';
const file = process.argv[2] ?? 'dist/sitemap-i18n.xml';
const xml = readFileSync(file, 'utf8');
// loc -> Map(hreflang -> href)
const entries = new Map();
for (const block of xml.match(/<url>[\s\S]*?<\/url>/g) ?? []) {
const loc = block.match(/<loc>(.*?)<\/loc>/)?.[1];
if (!loc) continue;
const alternates = new Map();
for (const m of block.matchAll(/<xhtml:link rel="alternate" hreflang="([^"]+)" href="([^"]+)"\/>/g)) {
alternates.set(m[1], m[2]);
}
entries.set(loc, alternates);
}
let problems = 0;
const report = (message) => {
console.log(message);
problems += 1;
};
for (const [loc, alternates] of entries) {
if (alternates.size === 0) continue; // halaman satu bahasa
if (![...alternates.values()].includes(loc)) report(`Tanpa self-reference: ${loc}`);
if (!alternates.has('x-default')) report(`Tanpa x-default: ${loc}`);
for (const [lang, href] of alternates) {
if (lang === 'x-default') continue;
const target = entries.get(href);
if (!target) {
report(`Alternate tidak ada di sitemap: ${loc} -> ${href}`);
} else if (![...target.values()].includes(loc)) {
report(`Tidak timbal balik: ${href} tidak menunjuk balik ke ${loc}`);
}
}
}
console.log(`${entries.size} URL diperiksa, ${problems} masalah.`);
process.exit(problems > 0 ? 1 : 0);
Jalankan setelah build:
npx astro build
node scripts/cek-hreflang.mjs dist/sitemap-i18n.xml
Karena skrip keluar dengan kode 1 saat ada masalah, Anda bisa memasangnya di CI sebagai gerbang sebelum deploy. Untuk memastikan HTML di production sama dengan sitemap, cek satu pasangan secara acak:
curl -s https://tokokopi.example/en/services/ | grep -E 'rel="(canonical|alternate)"'
Membaca sinyal Google Search Console
Satu hal yang perlu diluruskan dulu: laporan International Targeting yang dulu menampilkan error hreflang di GSC sudah dihentikan Google sejak 2022. Jadi tidak ada lagi satu layar yang berkata “hreflang Anda benar”. Yang tersisa adalah sinyal tidak langsung, dan menurut saya justru lebih jujur, karena yang kita ukur adalah hasilnya: versi bahasa mana yang diindeks dan kepada siapa ia ditampilkan.
1. Laporan Sitemaps. Kirim sitemap-i18n.xml, lalu pastikan statusnya berhasil dibaca dan jumlah halaman yang ditemukan sama dengan jumlah <url> di file Anda. Selisih berarti ada URL yang tidak bisa diproses.
2. URL Inspection per pasangan. Ambil beberapa pasangan halaman penting, misalnya beranda dan halaman layanan dalam dua bahasa. Bandingkan User-declared canonical dengan Google-selected canonical. Untuk halaman /en/services/, keduanya harus /en/services/. Kalau Google memilih /layanan/ sebagai canonical untuk halaman Inggris, itu tanda Google menganggap keduanya duplikat. Penyebab yang paling sering adalah terjemahan yang belum utuh.
3. Laporan Page indexing, difilter per sitemap. Pilih sitemap-i18n.xml di filter laporan, lalu perhatikan dua alasan ini untuk URL di bawah /en/:
- Duplicate, Google chose different canonical than user: sinyal yang sama dengan poin 2, tetapi dalam skala seluruh situs.
- Alternate page with proper canonical tag: wajar untuk varian seperti URL berparameter, tetapi tidak wajar untuk halaman versi bahasa yang seharusnya berdiri sendiri. Kalau halaman
/en/Anda masuk sini, periksa lagi canonical-nya.
4. Laporan Performance sebagai matriks bahasa dan negara. Ini bagian favorit saya karena menjawab pertanyaan “apakah orang yang tepat melihat versi yang tepat”. Buat empat irisan dengan filter Page (URL berisi /en/ atau tidak berisi /en/) dan filter Country (Indonesia atau selain Indonesia), lalu catat impresi dan klik masing-masing:
| Irisan | Yang diharapkan | Tanda masalah |
|---|---|---|
| Halaman Indonesia × pengguna Indonesia | Porsi terbesar impresi dan klik situs | Turun tajam setelah versi Inggris rilis |
| Halaman Inggris × pengguna Indonesia | Ada, terutama untuk query berbahasa Inggris | Muncul untuk query berbahasa Indonesia; cek tab Queries |
| Halaman Inggris × pengguna luar Indonesia | Tumbuh pelan setelah hreflang terpasang | Tetap nol berbulan-bulan, kemungkinan versi Inggris tidak terindeks |
| Halaman Indonesia × pengguna luar Indonesia | Kecil, umumnya dari diaspora atau negara tetangga | Besar untuk query berbahasa Inggris, artinya pasangan Inggris tidak dikenali |
Bandingkan periode 28 hari sebelum dan sesudah deploy, bukan harian. Data Performance biasanya tertinggal beberapa hari, dan Google perlu merayapi ulang kedua sisi pasangan sebelum anotasinya berlaku. Kalau Anda butuh tabel silang halaman dan negara dalam satu laporan, Search Console API mendukung kombinasi dimensi page dan country, sedangkan antarmuka web lebih praktis dipakai dengan filter seperti di atas.
Penutup: checklist di Hari Sumpah Pemuda
Menjunjung Bahasa Indonesia di situs dwibahasa bukan soal menaruh versi Indonesia di root lalu berharap. Ini soal memberi Google instruksi yang konsisten dan memverifikasinya dengan data. Urutan kerja yang saya sarankan:
- Struktur URL: Bahasa Indonesia di root, Inggris di
/en/, tanpa redirect otomatis berdasarkan IP. - Satu peta rute sebagai sumber kebenaran untuk canonical, hreflang di HTML, dan sitemap.
- Kode
iddanen, self-reference, timbal balik, URL absolut yang identik dengan canonical. - Tentukan
x-defaultberdasarkan data negara di GSC. - Canonical setiap versi bahasa menunjuk ke dirinya sendiri.
- Jalankan skrip cek di CI, lalu kirim sitemap ke GSC.
- Pantau URL Inspection, Page indexing per sitemap, dan matriks Performance selama 28 hari.
Ukuran keberhasilannya sederhana: pengguna Indonesia yang mencari dalam Bahasa Indonesia mendarat di halaman Indonesia, dan pengguna yang mencari dalam Bahasa Inggris mendarat di halaman Inggris. Kalau matriks di GSC sudah menunjukkan pola itu, setup Anda bekerja.
Ditulis oleh Putri Andini