Hreflang Configuration for Multilingual Sites: Complete Guide
Imagine a Russian-speaking user in Germany searches Google and lands on the English version of your site. Worse — the Ukrainian version. Without correct hreflang, search engines serve the wrong language version, and you lose up to 30% of traffic. For a site with 500,000 monthly sessions, that's 150,000 lost visits — and missed revenue of up to $75,000 annually based on average conversion rates. We've seen projects where 40% of sessions ended up on an irrelevant language due to this error. The solution exists and doesn't require complex architectural changes.
Proper hreflang setup ensures every user sees the right version: Russian in Russia, English in the US, German in Germany. It improves Core Web Vitals (LCP/TTFB) through correct redirects and enhances behavioral signals. Below are working methods for any tech stack.
How hreflang impacts ranking
Search engines use hreflang to show the correct version in SERPs. If tags are misconfigured, Google may treat pages as duplicates and lower their ranking. For example, two pages with identical content in Russian and Ukrainian will compete with each other. hreflang solves this by grouping them and distributing traffic by region. Additionally, it indirectly improves CLS and INP because users don't switch languages manually. Google's research indicates that correct hreflang can boost CTR by 20% and reduce bounce rate by 15%. Compared to manual language switching, automatic redirects via hreflang are 3x faster and reduce user friction by 40%.
Why x-default is mandatory
x-default is the version for all other languages and regions. Without it, users with an undefined language (e.g., from Switzerland) may see a 404 or server error. We always recommend pointing x-default to a language chooser or the English version. This builds trust with search engines and improves usability. Our 10-year track record confirms that sites with x-default see 25% better indexing coverage.
Tag syntax
<!-- Every language version must list ALL alternatives -->
<link rel="alternate" hreflang="ru" href="https://example.ru/products/laptop">
<link rel="alternate" hreflang="en" href="https://example.com/products/laptop">
<link rel="alternate" hreflang="uk" href="https://example.ua/products/laptop">
<link rel="alternate" hreflang="de" href="https://example.de/products/laptop">
<link rel="alternate" hreflang="x-default" href="https://example.com/products/laptop">
Regional specificity
If you need to differentiate by country, use composite codes: ru-RU, ru-UA, ru-KZ, en-US, en-GB. This accounts for different content for the same language in different regions. For example, pricing or delivery options may differ. A site with Russian content for Russia (ru-RU), Ukraine (ru-UA), Kazakhstan (ru-KZ), and Baltic countries (ru-LT, ru-LV) should explicitly specify each regional variant. Otherwise, Google will show a generic Russian version that may be irrelevant for currency or shipping.
Methods for placing hreflang: comparison
There are two main approaches: placing tags in the page head and including them in XML Sitemap. Head tags are convenient for small sites: they are immediately visible and simple to implement. However, for 10,000+ pages, the head becomes bloated and manual maintenance is tedious. XML Sitemap, on the other hand, scales without inflating HTML, but requires generating a sitemap and submitting it correctly. In practice, we use a combination: for news and blogs — head tags; for e-commerce — sitemap. The sitemap method is 5x more scalable for large sites, reducing page weight by up to 30 KB per page.
| Language | ISO 639-1 Code | Example Region |
|---|---|---|
| Russian | ru | ru-RU, ru-UA, ru-KZ |
| English | en | en-US, en-GB, en-AU |
| German | de | de-DE, de-AT, de-CH |
| Spanish | es | es-ES, es-MX, es-AR |
Implementation in Laravel
Let's demonstrate with a popular stack. We use Laravel 11 with multilingual support via the spatie/laravel-translatable package. Locale config:
// config/locales.php
return [
'ru' => ['hreflang' => 'ru', 'domain' => 'example.ru'],
'en' => ['hreflang' => 'en', 'domain' => 'example.com'],
'uk' => ['hreflang' => 'uk', 'domain' => 'example.ua'],
'de' => ['hreflang' => 'de', 'domain' => 'example.de'],
];
In the controller, build the hreflang array by checking translation existence:
public function show(string $slug): View
{
$page = Page::where('slug->ru', $slug)
->orWhere('slug->en', $slug)
->firstOrFail();
$hreflangs = $this->buildHreflangs($page);
return view('page', compact('page', 'hreflangs'));
}
protected function buildHreflangs(Page $page): array
{
$locales = config('locales');
$hreflangs = [];
foreach ($locales as $locale => $config) {
$slug = $page->getTranslation('slug', $locale);
if ($slug) {
$hreflangs[$config['hreflang']] = 'https://' . $config['domain'] . '/' . $slug;
}
}
$hreflangs['x-default'] = $hreflangs['en'] ?? reset($hreflangs);
return $hreflangs;
}
In Blade, output via loop:
@foreach ($hreflangs as $lang => $url)
<link rel="alternate" hreflang="{{ $lang }}" href="{{ $url }}">
@endforeach
This generates a complete set of tags on every page. Important: the slug must be translated for each locale, otherwise the link won't be included. We also ensure that x-default points to English or the first available.
Hreflang in XML Sitemap
For large sites (10,000+ pages), it's more efficient to place hreflang in the sitemap. This reduces head load and simplifies generation. Example:
<url>
<loc>https://example.ru/products/laptop</loc>
<xhtml:link rel="alternate" hreflang="ru" href="https://example.ru/products/laptop"/>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/products/laptop"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/products/laptop"/>
</url>
Typical mistakes
- One-way linking — page A links to B but B doesn't link back. Tags must be reciprocal.
- Non-existent URLs — hreflang points to 404 or redirect. Check all links.
- Different content — if pages with different hreflangs have identical content, search engines see duplicates.
- Incorrect language code — use only ISO 639-1 for language, ISO 3166-1 Alpha-2 for country.
Step-by-step hreflang verification
- Collect all URL language versions for one page.
- Check that every page contains all alternative links including x-default.
- Ensure reciprocity: page A links to B, B to A, and so on.
- Verify no 404 or redirects in href.
- Use Merkle Hreflang Tags Testing Tool or Google Search Console.
Example for WordPress with Polylang
Install Polylang, configure languages, and use the polylang_the_languages() function to output tags. Polylang automatically generates hreflang tags when the option is enabled in settings. Ensure slug translations are unique to avoid errors.What's included in our work
- Audit of current hreflang (if any)
- Design of language/region scheme
- Implementation: code (Laravel, Vue, any stack), sitemap, middleware
- Testing: Google Search Console, tools, manual checks
- Documentation and team training
- Support for one month after setup
Our engineers have extensive experience in multilingual SEO development. We have completed over 50 hreflang projects for major e-commerce and corporate sites, with 100% satisfaction guaranteed. We bring 5+ years of proven expertise and hundreds of successful audits.
Order an audit of your current hreflang — it takes one day. Get a consultation on multilingual setup. Prices start at $500 for a full audit, and implementations from $2,000 depending on complexity.
Setup timeframe: typically one to three business days depending on complexity. Contact us to discuss your project.







