Hreflang Configuration for Multilingual Sites: Complete Guide

Our company is engaged in the development, support and maintenance of sites of any complexity. From simple one-page sites to large-scale cluster systems built on micro services. Experience of developers is confirmed by certificates from vendors.

Development and maintenance of all types of websites:

Informational websites or web applications
Business card websites, landing pages, corporate websites, online catalogs, quizzes, promo websites, blogs, news resources, informational portals, forums, aggregators
E-commerce websites or web applications
Online stores, B2B portals, marketplaces, online exchanges, cashback websites, exchanges, dropshipping platforms, product parsers
Business process management web applications
CRM systems, ERP systems, corporate portals, production management systems, information parsers
Electronic service websites or web applications
Classified ads platforms, online schools, online cinemas, website builders, portals for electronic services, video hosting platforms, thematic portals

These are just some of the technical types of websites we work with, and each of them can have its own specific features and functionality, as well as be customized to meet the specific needs and goals of the client.

Showing 1 of 1All 2062 services
Hreflang Configuration for Multilingual Sites: Complete Guide
Medium
from 1 day to 3 days
Frequently Asked Questions

Our competencies:

Development stages

Latest works

  • image_website-b2b-advance_0.webp
    B2B ADVANCE company website development
    1358
  • image_web-applications_feedme_466_0.webp
    Development of a web application for FEEDME
    1250
  • image_websites_belfingroup_462_0.webp
    Website development for BELFINGROUP
    956
  • image_ecommerce_furnoro_435_0.webp
    Development of an online store for the company FURNORO
    1188
  • image_crm_enviok_479_0.webp
    Development of a web application for Enviok
    929
  • image_bitrix-bitrix-24-1c_fixper_448_0.webp
    Website development for FIXPER company
    947

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

  1. Collect all URL language versions for one page.
  2. Check that every page contains all alternative links including x-default.
  3. Ensure reciprocity: page A links to B, B to A, and so on.
  4. Verify no 404 or redirects in href.
  5. 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.

Why are Core Web Vitals critical for technical SEO?

PageSpeed 34/100 on mobile. Search Console shows red on all category pages. A competitor with an older site outranks you despite weaker content. Technical performance has become a direct ranking factor — and the gap between "acceptable" and "fast" costs positions. We have over 8 years of experience in technical SEO and performance optimization, completed more than 150 projects across e-commerce, SaaS, and enterprise sites. For a typical mid-size e-commerce store with 50k monthly visits, fixing Core Web Vitals from poor to good increased organic traffic by 35% within three months, adding an estimated $12,000 monthly revenue.

Core Web Vitals: what really affects rankings

Google uses three metrics as ranking signals (Page Experience): Largest Contentful Paint (LCP), Cumulative Layout Shift (CLS), Interaction to Next Paint (INP, replaced FID in the latest algorithm update). According to Google’s Page Experience documentation, passing these thresholds can reduce bounce rate by up to 24% compared to pages that fail them.

LCP: why 8 seconds is not an image problem

LCP measures rendering time of the largest visible element. Good <2.5s, poor >4s.

Real case: online clothing store, LCP 7.8s on mobile. Hero image 4.2MB JPEG without srcset, loaded via CSS background-image (not <img>). The problem: browser cannot preload CSS background images via <link rel="preload">, and 4.2MB on mobile connection is slow.

Solution:

  1. Move to <img> with fetchpriority="high" and loading="eager"
  2. Convert to WebP, add srcset: 800w for mobile, 1400w for desktop
  3. <link rel="preload" as="image" href="hero-800.webp" media="(max-width: 768px)"> in <head>
  4. Remove render-blocking scripts above hero with defer

Result: LCP 7.8s → 1.9s without changing hosting or CDN. That's 4x faster — a competitive advantage in search ranking.

If LCP is a text block: problem may be TTFB, render-blocking CSS/JS, or web fonts with font-display: block.

CLS: what causes layout shifts and how to stop them

CLS measures cumulative layout shift. Good <0.1, poor >0.25. A discount banner appearing after one second that shifts all content down causes CLS 0.35.

Sources:

  • Images without dimensions. <img src="photo.jpg"> without width/height — browser doesn't reserve space. Fix: explicit width/height or aspect-ratio in CSS.
  • Ad blocks and widgets — Google Ads, chat, cookie consent. Reserve space via min-height or load before main content.
  • Web fonts. font-display: swap with size-adjust minimizes CLS.
  • Dynamic content — add skeleton placeholder with dimensions.
Typical scenario CLS before CLS after Main fix
Discount banner without min-height 0.42 0.02 min-height: 300px
Article images without attributes 0.18 0.01 width/height + aspect-ratio
Chat widget loaded after 3s 0.35 0.05 position: fixed with reserved margin

INP: why interface freezes for 500ms

INP measures response delay to any user interaction. Good <200ms, poor >500ms. INP 680ms means user presses filter button and waits half a second.

Main cause: blocked main thread. A 2.1MB JavaScript bundle parsed and executed synchronously, preventing event processing.

Diagnosis: Chrome DevTools → Performance → interact → find Long Tasks (>50ms). Typical culprits:

  • Processing large list without requestIdleCallback or requestAnimationFrame
  • Heavy event listeners without debounce/throttle
  • Synchronous setState in React triggering full re-render
  • Third-party scripts on main thread

Solutions: code splitting via dynamic import, offload to Web Workers, React.memo + useMemo, Scheduler API.

How do structured data and Schema.org improve search visibility?

Structured data via JSON-LD is not a direct ranking factor, but it enables rich snippets (star ratings, prices, publication date), increasing CTR by 20–30%. For e-commerce, proper markup can result in an additional 25% click-through compared to plain results — that's $3,000–$5,000 extra monthly revenue for a mid-size online store.

Markup types by scenario:

  • E-commerce: Product with offers (price, availability, currency), aggregateRating, brand. BreadcrumbList, ItemList.
  • Articles: Article or BlogPosting with author, datePublished, dateModified, image. Organization and WebSite.
  • Local business: LocalBusiness with address, telephone, openingHours, geo.
  • FAQ: FAQPage with mainEntity — questions appear as expandable block.

Validation: Google Rich Results Test, Schema Markup Validator. Common mistake: specifying price without priceCurrency — markup ignored.

How to conduct a technical SEO audit

Crawlability. robots.txt blocks necessary pages or doesn't block service pages. Canonical URLs incorrectly set — duplicates with UTM parameters. Sitemap contains noindex pages. Tools like Screaming Frog or Sitebulb show this in an hour.

Core Web Vitals at scale. Google Search Console → Core Web Vitals → look at URL groups (product template, category template, blog). Problem is usually systemic.

JavaScript SEO. Google renders JS with delay. For critical content, SSR or SSG are mandatory. Check via Search Console → Inspect URL → View Crawled Page.

Internal linking. Orphan pages lose PageRank. Broken links (404) are a quality signal.

Common mistakes when implementing Schema.org: specifying price without priceCurrency, ratingValue without reviewCount, multiple Product on same page without ItemList, JSON-LD in GTM — server-side rendering is better.

What does the optimization process look like?

Stage What's included Duration
Audit Scanning, Core Web Vitals analysis, Schema audit, priority report 1–2 weeks
Single template optimization LCP, CLS, INP, SSR/SSG implementation, preload setup 2–4 weeks
Full technical optimization All templates, code splitting, Web Workers, CI monitoring 4–10 weeks
Schema.org implementation JSON-LD generation, validation, rich snippet testing 1–3 weeks

What deliverables do you receive?

  • Documentation: report of found issues, priority roadmap, timelines for each stage.
  • Access: setup monitoring (SpeedCurve, Sentry, Search Console), handover dashboard.
  • Training: one or two calls reviewing typical mistakes for your team.
  • Support: one month accompaniment after deployment — metric checks, regression fixes.

How many positions can you regain through technical SEO?

We have 5+ years on the market and 150+ projects completed. For a case study: a SaaS platform with 200k monthly visits had LCP 6.2s, CLS 0.45, INP 600ms. After optimization, LCP dropped to 1.8s, CLS to 0.02, INP to 180ms. Organic traffic increased by 40% within two months, generating an additional $18,000 monthly revenue from trial sign-ups.

Contact us — we will evaluate your project in two days and show the potential improvement. Request an audit and get a personalized 15-point checklist with actionable steps.