Google Updates hreflang Documentation While I Was Offline

Jun 17, 2024 - 7:11 am 0 by

Google Logo On Map

Google has tweaked its hreflang search developer documentation to clarify that link tags for denoting alternate versions of a page must not be combined in a single link tag. Google said it wanted to document this "quirk" in its documentation.

The old documentation wrote:

Put your link tags near the top of the head element. At minimum, the link tags must be inside a well-formed head section, or before any items that might cause the head to be closed prematurely, such as p or a tracking pixel. If in doubt, paste code from your rendered page into an HTML validator to ensure that the links are inside the head element.

Now it reads:

The link tags must be inside a well-formed head section of the HTML. If in doubt, paste code from your rendered page into an HTML validator to ensure that the links are inside the head element. Additionally, don't combine link tags for alternate representations of the document; for example don't combine hreflang annotations with other attributes such as media in a single link tag.

Gary Illyes from Google posted on LinkedIn with more details. He said, "We made an update to our hreflang documentation to note that alternate page version references should not be combined into a single link HTML element."

"If that sentence was confusing, welcome to the club. Let's say you have an m-dot mobile version of your page, but also different language versions. You'd be tempted to do something like this:"

Here is a screenshot so you can see what he wrote fully:

Gary Illyes Hreflang Linkedin Post

Of course, there is this "This is not actually new, we just documented it now because Barry is out of office so he can't write about it."

Forum discussion at LinkedIn.

 

Popular Categories

The Pulse of the search community

Search Video Recaps

 
Video Details More Videos Subscribe to Videos

Most Recent Articles

Google Search Engine Optimization

Google Search On JavaScript-Based Paywalls

Aug 29, 2025 - 7:11 am
Search Forum Recap

Daily Search Forum Recap: August 28, 2025

Aug 28, 2025 - 10:00 am
Google Search Engine Optimization

Some Sites Have Huge Crawl Rate Declines In Google Search Console

Aug 28, 2025 - 9:30 am
Google Search Engine Optimization

Bug: Google Search Console Performance Report Search Appearance Android App

Aug 28, 2025 - 7:51 am
Bing Ads

Microsoft Testing Tests Larger Titles For Ads In Bing Search

Aug 28, 2025 - 7:41 am
Google Ads

Google Ads Gets Audience Exclusions For Shopping Campaigns

Aug 28, 2025 - 7:31 am
 
Previous Story: Google Now Allow Some Opioid Painkillers Ads