International SEO’s Trickiest Tag, Made Simple
Hreflang is the tag everyone knows they need and almost everyone implements wrong. The concept is straightforward: tell Google which language version of your page to show which users. The execution is brutal, every page must reference every other language version, including itself, and a single missing return tag can break the whole thing.
Add your language/region + URL pairs, set an x-default, and the tool generates the complete bidirectional tag set with validation for duplicate entries. Copy and paste into the <head> of each page variant.
The Problem It Solves
You’ve got your pricing page in English, Spanish, and French. Without hreflang, Google might show the English version to Spanish speakers, or worse, flag the Spanish translation as duplicate content of the English page. Either way, you’re losing traffic.
With proper hreflang tags, Google serves example.com/pricing to English speakers, example.com/es/pricing to Spanish speakers, and example.com/fr/pricing to French speakers. The x-default URL catches everyone else.
The Most Common Mistake
Forgetting return tags. If your English page has hreflang tags pointing to the Spanish and French versions, but the Spanish page only points to English (forgetting French), Google can’t validate the relationship and may ignore the tags entirely.
Each page must reference ALL versions, including itself. For three languages, that’s three <link> tags on every page, plus x-default. For ten languages, that’s ten tags on every page. This tool generates the complete set so you don’t miss any.
Language vs. Region Codes
Use just a language code (en, es, fr) when your content is the same for all speakers of that language worldwide. Add a region code (en-US vs en-GB, es-ES vs es-MX) when content differs by country, different pricing, legal disclaimers, cultural references, or currency.
Works with any URL structure, subdirectories (/en/, /es/), subdomains (en.example.com), or separate domains (example.com, example.es). Google doesn’t care which approach you use as long as the hreflang tags are correct.
Pair this with the Canonical URL Generator to make sure each language version has both canonical and hreflang tags properly set. Everything runs in your browser.