Skip Navigation
September 19, 2023

The hreflang attribute tells Google about available translations for a given page or post. When used correctly, it can dramatically improve search engine positioning, because Google will understand which translation to display for people in different places.

On This Page:

Hreflang Attributes Help Google Display the Right Translation in Search Results

When you search for something in Google, Google knows where you are located and which language you prefer. It does this through your IP address and browser settings.

The hreflang attributes allow websites to tell Google which translations (or country-specific content) you offer for people in different places who speak different languages.

Using hreflang attributes, you can display language-specific and country-specific content to people speaking these languages and in these countries.

Of course, for this “magic” to happen, some conditions have to be met.

Required Conditions for Hreflang to Work Correctly

Use Hreflang Attributes to Connect Translations or Localizations of the Same Content

First and foremost, be sure to only use hreflang tags to connect content that is essentially the same, just in different languages or localized for different countries.

If you use hreflang tags to tie together content that’s significantly different, you will only confuse Google. As a result, don’t expect any good results.

Place Hreflang Attributes in the Header Section of the HTML

HTML documents include a header and a body. The hreflang tags must appear inside the header. They should look like the following example:

Hreflang tags in’s HTML header

Include Complete Sets of Documents with Hreflang

We understand that hreflang attributes indicate to Google about available translated or localized content. So it follows that if item-B is equivalent to item-A, then also item-A is equivalent to item-B. That’s pretty obvious.

This means that items connected using hreflang need to form complete sets. All items in the set have to link to all other items. Google also requires that items link to themselves.

For example, a piece of content is available in English, French, Spanish, and Italian, the English version has to link to the translated French, Spanish, and Italian versions and also to itself.

How WPML Creates Hreflang Tags

The value of the hreflang attribute identifies the language and, optionally, the region of an alternate URL.

If you have geographically unspecified users, the hreflang follows a two-letter format according to standard codes. If you have specific URLs for users in different regions, a second two-letter value corresponds to the region and should be set according to the international rules.

For example:

  • fr: French content, independent of region
  • fr-CA: French content for users from Canada
  • fr-FR: French content for users from France

Which option should you choose? This depends on how your site’s content is organized:

  • If your site has versions of your content in the same language but with minor differences based on locale (like different currencies, contact details or purchase instructions), you should use region-specific hreflang attributes. This tells Google that the content is not duplicate, but intended for different countries.
  • If your site has content in several languages, but not specialized for different countries, you should use hreflang attributes with just language information.

How to Add Hreflang Attributes with WPML

Defining Hreflang Attributes

WPML retrieves the hreflang value from the setting found at WPMLLanguages and clicking on Edit Languages.

Hreflang values on the Edit Languages page

New installations of WPML already have the hreflang properly filled. However, WPML always tries to adjust these codes when rendering the hreflang elements and find the best and more complete value. To do this, it will sometimes replace the underscores with a dash and make the string lowercase.

For example, if you use the value fr_ca, WPML will transform it into fr-CA.

However, even though WPML does its best to render the right hreflang, it is not able to check if it has valid format or not. For example, an fr-CA hreflang should match the language-country structure as we mentioned before. WPML is not able to warn you if you are using an invalid country-language format instead.

If WPML cannot find a suitable value, it won’t render a hreflang for that language.

Adding Hreflang Attributes to the HTML Header

When you use WPML to build multilingual WordPress sites, WPML will add hreflang to the HTML header as close as possible to the beginning of the <head> section. You can adjust this by going to WPMLLanguagesSEO Options.

Choosing where to display hreflang attributes in the header

The option to display the hreflang link attributes at lower priority is a fallback, which is useful if some themes trigger WPML initialization too early. In addition to the position of these tags in the header, you can control the language/locale codes that WPML will output in the tags.

These tags will automatically link to all available translations and to the same language. If an item is translated to only part of the site’s languages, WPML will include hreflang links only to these languages.

Learn More

For a comprehensive guide to hreflangs we suggest reading Ahref’s easy guide for beginners.