Hreflang Tags Generator

How to use

1. Paste one URL per line — one for each language version of the same page.
2. Pick the language for each URL, add the region when the version targets a specific country, and use x-default for the fallback version.
3. Copy the block and paste it into the of every page you listed, including the page itself.

About this tool

Hreflang is the signal that tells search engines which language and which country each version of a page is meant for. It lives in the as a set of tags, one per version, and on its own it does not make anything rank higher: it decides which version is shown to which user. Without it a Brazilian searcher may land on the Portuguese page written for Portugal, or on the English one, and leave immediately. This generator turns a plain list of URLs into that block, letting you set the language and the optional region for each line, plus the special x-default value for the version that catches everyone else.

Language codes follow ISO 639-1 — two letters such as pt, en or es — and the optional region follows ISO 3166-1 alpha-2, like BR, PT or US. The two are joined as language-REGION (pt-BR, en-GB), and a language with no region is perfectly valid when you are not targeting a country. The tool reads the URL path and pre-selects a language when it finds a segment like /pt-br/ or /es/, which you can always override, and it escapes ampersands and angle brackets so the markup cannot break. The rule that trips most people is reciprocity: every page in a set must list every version of that set, including itself. If your English page points to the Portuguese one and the Portuguese one does not point back, search engines discard the whole cluster — which is why the block generated here is meant to be pasted identically into all of them.

The typical case is a site with a handful of localized pages: a landing page in Portuguese, Spanish and English, a documentation section translated for two markets, or a store with country-specific pricing. Writing those tags by hand is error-prone and the errors are silent — nothing looks broken, the wrong version simply keeps showing up in search. Generating the block removes the typos and makes the set easy to review at a glance. Everything runs in JavaScript on your device: the URLs you paste are never uploaded and no server is involved. The same information can also be delivered through XML sitemaps or HTTP headers, but the head block is the most common form and the easiest to audit.

Frequently asked questions