How to Add Hreflang Tags in WordPress

WordPress doesn't add hreflang tags out of the box. You need either a multilingual plugin that handles it automatically, an SEO plugin with hreflang support, or manual code. Here's how each approach works.

Method 1: WPML (recommended for complex multilingual sites)

WPML (WordPress Multilingual Plugin) is the most widely used multilingual plugin for WordPress. It manages translated content and automatically outputs hreflang tags based on your translation structure.

WPML handles the return link requirement automatically -- every translated page gets the full cluster of hreflang tags. It also respects your canonical tags.

Method 2: Polylang

Polylang is a free alternative to WPML (with a paid Pro version). It has native hreflang support.

Polylang Pro adds more URL configuration options (subdirectory, subdomain, separate domain per language). The free version supports subdirectory and language parameter approaches.

Method 3: Yoast SEO

Yoast SEO on its own doesn't generate hreflang tags -- that functionality is in Yoast SEO Premium when combined with a multilingual plugin. Yoast works alongside WPML and Polylang.

Where Yoast matters: it controls the canonical tag. Make sure your Yoast canonical settings don't conflict with the hreflang tags your multilingual plugin outputs. See hreflang and canonical tags for how these interact.

Method 4: Rank Math

Rank Math SEO has built-in multilingual support. When used alongside WPML or Polylang, it picks up the language relationships those plugins define and outputs the hreflang tags.

In Rank Math's settings under General > Links, confirm the canonical URL settings are consistent with your language URLs. Rank Math + WPML is a common stack and they play together well.

Method 5: Manual via functions.php

If you're not using a multilingual plugin and want to add hreflang manually, you can output tags via your theme's functions.php (or a custom plugin -- functions.php changes get wiped on theme updates).

function add_hreflang_tags() {
    // Only output on specific pages -- customize this condition
    if ( is_front_page() ) {
        echo '<link rel="alternate" hreflang="en" href="https://example.com/" />' . "\n";
        echo '<link rel="alternate" hreflang="fr" href="https://example.com/fr/" />' . "\n";
        echo '<link rel="alternate" hreflang="de" href="https://example.com/de/" />' . "\n";
        echo '<link rel="alternate" hreflang="x-default" href="https://example.com/" />' . "\n";
    }
}
add_action( 'wp_head', 'add_hreflang_tags' );

This approach works for simple sites with a small number of pages but becomes hard to maintain as the site grows. You're responsible for keeping return links consistent across all page templates manually.

WordPress Multisite considerations

On WordPress Multisite where each language is a separate site in the network, hreflang needs to reference URLs across different subsites. WPML has a multisite-compatible version. Polylang Pro also supports multisite networks.

If you're building hreflang across network sites manually, the process is the same as any cross-domain hreflang implementation -- just make sure you're using the correct absolute URLs for each site in the network.

Validate after setup

Whichever method you use, view source on several pages across different language versions and verify:

• Every page has a self-referencing hreflang tag
• Every page references all other language versions
• All URLs are absolute
• Language codes are valid (e.g., en-GB not en-UK)
• Canonical and hreflang self-reference match

---

Part of Boring Tools -- boring tools for boring jobs.