Build1 distinct publisher3 min readPublished
A vendor that generates hreflang tags explains why one missing return link discards an entire cluster, silently, while every page in that cluster still passes inspection on its own.
The Engineer · Build desk

Compiled by The EngineerSomething wrong?How this is made
The arithmetic is why this defect class survives review. Five language versions are not five checks. Each of the five pages has to name itself as well as its four alternates [2][5], which is twenty-five entries across the cluster [1], and every entry has to be answered by a matching one on the page it points at [3]. Add a sixth language and the count is thirty-six [2]. Miss a single reciprocal and Google has grounds to distrust the whole group [3], while each page in it continues to look correct when you view its source [4].
There is no shortage of ways for one entry to go bad without looking bad. `en-UK` is invalid because the region code comes from ISO 3166-1, which lists GB and has no UK; the author of the post calls it easily the most common hreflang error on the web [6]. Targets have to be final URLs, so an entry pointing at http when the server redirects to https, or omitting a trailing slash the server adds, resolves to a redirect rather than a page and does not count [7]. That one, according to the post, bites hardest after a migration, when the site still works fine for humans [7]. And the canonical conflict is the quiet one: hreflang says five pages are alternates, the canonical tags say four of them are copies of the fifth, and the two signals cancel [8]. Declaring the same alternates in HTML and in a sitemap is another reliable way to produce conflict, which is why the post says to pick one method [9].
The disclosure in the post is the more useful part, because the author's company builds a translation widget that generates hreflang tags for other people's sites [15]. That widget injects the tags from JavaScript after page load [10]. Google renders JavaScript, so those tags can be picked up, but rendering is a second pass on no guaranteed schedule, server-rendered tags are stronger, and other search engines are less reliable about running JavaScript at all [11]. The alternates are also built as a query parameter, `?lang=de`, which avoids duplicating anything in the CMS and avoids re-translating when a paragraph changes, at the cost of a clean path per language; a query parameter can be indexed, but `/de/` is a stronger signal [12]. On that basis the author points readers whose main goal is multilingual organic search towards GTranslate, which serves translated sites with translated URLs, or WPML and Polylang, which create a post per language [13]. The widget's case is the other one: visitors reading in their own language, no second copy of every page, hreflang as a useful signal rather than the whole strategy [16].
The first diagnostic the post recommends is worth reading as a statement about tooling rather than a tip: view source on two different language versions and compare them [14]. The unit of inspection is the pair, not the page. Anything that grades one URL at a time is measuring the wrong object, which is exactly how a cluster can be discarded in full without a single failing check anywhere in the report [1].
Ranked by verification strength, evidence, and original report placement.
hreflang either forms a valid set that search engines act on or does nothing at all, and the failure is completely silent: no warning, no penalty, and no Search Console message saying the tags have been discarded.
en-UK is silently invalid: the language code comes from ISO 639-1 and the region code from ISO 3166-1, in which the United Kingdom is GB and there is no UK. The post calls it easily the most common hreflang error on the web.
Google renders JavaScript so tags added that way can be picked up, but rendering happens in a second pass separately from the initial crawl and is not guaranteed on any particular schedule; server-rendered tags are stronger, and other search engines are less reliable about running JavaScript at all.
hreflang is not a property of a page but of a set of pages, and every page in that set has to agree.
If an English page says the German version is at /de/, the German page must say the English version is at /; otherwise the declaration is one-way and one-way declarations get dropped. Google calls these return links and treats their absence as a reason to distrust the whole set.
Every individual page looks correct when inspected; the problem exists only in the relationship between pages, which cannot be seen by viewing source on one URL.
Follow any of these and your For You feed starts watching them — no settings page required.
Evidence-backed comparisons of source perspectives and observed adoption signals. Read the methodology
Which Builder, Operator, and Investor concerns the observed source mix emphasized—not a truth score.
Evidence, demonstrated adoption, hype gap, incentives, and confidence are assessed independently, each on its own current evidence. How these are measured.
Internally consistent single-source practitioner account
All claims rest on one vendor-authored post. The mechanics are specific, self-consistent and partly checkable against public standards (ISO 639-1 and ISO 3166-1 code structure), and the author discloses the limits of its own product rather than only asserting strengths. But the cluster contains no search-engine documentation, no crawl or indexation data, no third-party audit, and no measurement behind prevalence claims such as en-UK being the most common error on the web, so corroboration is thin.
No usage or deployment data
The only adoption-adjacent facts are the vendor's own disclosures that it ships a translation widget generating hreflang on customer sites and a free browser-based generator/validator. Neither carries customer counts, site counts, downloads, traffic outcomes or third-party deployment evidence, and no adoption figures are given for the named alternatives GTranslate, WPML or Polylang. Nothing here supports a measured adoption level.
Claims stated more conservatively than typical vendor content
The post is unusually restrained relative to its commercial position: it discloses that its own tags are JavaScript-injected on a non-guaranteed second-pass render, that its query-parameter alternates are a weaker signal than per-language paths, that competitors are the right answer for organic-search-led localisation, and that its own free validator cannot check return links because no single-page tool can. The remaining overstatement is small and confined to unquantified prevalence language rather than to product capability.
Disclosed commercial interest in hreflang tooling
The author sells the thing the article diagnoses: a translation widget that generates hreflang tags, plus a free generator and validator promoted in the body. That is a direct incentive to frame hreflang as a hard, silent-failure problem best handled with tooling. The incentive is explicitly disclosed at the top and again mid-post, and is partly offset by concessions naming competitors as better fits and admitting the free tool cannot check return links, which lowers but does not remove the distortion risk.
Moderate: coherent mechanics, single interested source, no adoption data
Confidence rests on the specificity and internal consistency of the technical account and on the author's willingness to state adverse facts about its own product. It is capped by the cluster having one publisher, one vendor author, no independent corroboration of crawler behaviour, no quantification of failure prevalence, and no adoption evidence at all.
build
Cloudflare's one-click AI block names GPTBot, not the bot that decides if ChatGPT cites you1 distinct publisher
build
A 5x publishing increase cost one site 1,000 indexed pages and every impression1 distinct publisher
build
Thirteen of sixteen pages indexed overnight, no backlinks: the indexing bundle has a problem1 distinct publisher
build
Search Console starts reporting on posts you do not host, if you can verify them1 distinct publisher
Distinct publishers with included, body-backed reporting in this cluster.
dev.to
1 article · August 25, 2026