Hreflang for international SEO - Mini Project: Build & Apply

Hreflang for International SEO

📖 Scenario: You manage a website that serves users in different countries and languages. To help search engines show the right version of your pages to the right users, you need to use hreflang tags correctly.This project will guide you step-by-step to add hreflang tags to your HTML pages for international SEO.

🎯 Goal: Build a set of hreflang tags in the HTML <head> section that correctly link language and regional versions of a webpage.

📋 What You'll Learn

Create a list of URLs for different language versions of a page

Define the language and region codes for each URL

Write hreflang link tags for each language version

Add a default hreflang tag for users without a specific language preference

💡 Why This Matters

🌍 Real World

Websites that serve users in multiple languages and countries use hreflang tags to tell search engines which page version to show to which user.

💼 Career

SEO specialists and web developers use hreflang tags to improve international search rankings and user experience.

1

Create a list of page URLs for different languages

Create a list called page_urls containing these exact URLs as strings: "https://example.com/en-us", "https://example.com/fr-fr", "https://example.com/es-es".

SEO Fundamentals

# Create the list of page URLs
# Your code here

Hint

Use square brackets [] to create a list and include the URLs as strings inside quotes.

2

Define language-region codes for each URL

Create a list called hreflang_codes with these exact strings: "en-US", "fr-FR", "es-ES".

SEO Fundamentals

page_urls = ["https://example.com/en-us", "https://example.com/fr-fr", "https://example.com/es-es"]
# Create the list of hreflang codes
# Your code here

Hint

Use a list of strings matching the language and region codes for each URL.

3

Write hreflang link tags for each language version

Use a for loop with variables url and code to iterate over zip(page_urls, hreflang_codes). Inside the loop, create a string called link_tag with this exact format: <link rel="alternate" hreflang="{code}" href="{url}" /> using f-strings.

SEO Fundamentals

page_urls = ["https://example.com/en-us", "https://example.com/fr-fr", "https://example.com/es-es"]
hreflang_codes = ["en-US", "fr-FR", "es-ES"]
# Create hreflang link tags using a for loop
# Your code here

Hint

Use zip() to pair URLs and codes, then create the link tag string with f-strings.

4

Add a default hreflang tag for unspecified languages

Add a string variable called default_tag with this exact value: <link rel="alternate" hreflang="x-default" href="https://example.com/en-us" />.

SEO Fundamentals

page_urls = ["https://example.com/en-us", "https://example.com/fr-fr", "https://example.com/es-es"]
hreflang_codes = ["en-US", "fr-FR", "es-ES"]
for url, code in zip(page_urls, hreflang_codes):
    link_tag = f''
# Add the default hreflang tag
# Your code here

Hint

The x-default hreflang tag is used as a fallback for users without a matching language.

Practice

1. What is the main purpose of using hreflang tags in international SEO?

easy

A. To tell search engines which language or regional version of a page to show users

B. To increase the number of backlinks to a website

C. To speed up website loading times

D. To hide duplicate content from search engines

Solution

1. Step 1: Understand the role of hreflang tags

   hreflang tags tell search engines which language or regional version of a page should be shown to users based on their location or language preference.

2. Step 2: Compare with other SEO goals

   While backlinks, speed, and duplicate content are important SEO factors, hreflang specifically addresses language and regional targeting.

3. Final Answer:

   To tell search engines which language or regional version of a page to show users -> Option A

4. Quick Check:

   Purpose of hreflang = language/region targeting [OK]

Hint: Remember: hreflang = language + region targeting [OK]

Common Mistakes:

• Confusing hreflang with backlink strategies
• Thinking hreflang speeds up the site
• Assuming hreflang hides duplicate content

2. Which of the following is the correct syntax to specify a hreflang tag for a Spanish page targeting Spain?

easy

A.

B.

C.

D.

Solution

1. Step 1: Identify correct hreflang format

   The correct format uses a hyphen between language and region codes, like "es-ES" for Spanish in Spain.

2. Step 2: Check href URL matches language and region

   The URL should point to the Spanish page, so "https://example.com/es/" is correct. points to English, so it's incorrect.

3. Final Answer:

   <link rel="alternate" hreflang="es-ES" href="https://example.com/es/" /> -> Option C

4. Quick Check:

   Correct hreflang format = language-region with hyphen [OK]

Hint: Use hyphen between language and region codes [OK]

Common Mistakes:

• Using underscore instead of hyphen
• Mismatch between hreflang and URL language
• Omitting region code when needed

3. Given the following hreflang tags in the <head> section:

<link rel="alternate" hreflang="en" href="https://example.com/en/" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/" />

If a user in Germany visits the site, which URL will search engines likely show in search results?

medium

A. https://example.com/fr/

B. https://example.com/de/

C. https://example.com/en/

D. The homepage without language specification

Solution

1. Step 1: Match user location with hreflang tags

   The user is in Germany, so the hreflang tag with "de" matches their language/region.

2. Step 2: Determine which URL corresponds to "de" hreflang

   The URL "https://example.com/de/" is linked to the German version, so search engines will prefer this for German users.

3. Final Answer:

   https://example.com/de/ -> Option B

4. Quick Check:

   User location matches hreflang "de" = German page shown [OK]

Hint: Match hreflang code to user language/region [OK]

Common Mistakes:

• Ignoring hreflang and showing default language
• Confusing language codes
• Assuming homepage is always shown

4. A website has these hreflang tags:

<link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/" />

Users from the UK report seeing the US page in search results. What is the likely error?

medium

A. The hreflang tags are missing the x-default tag

B. The URLs for en-GB and en-US are swapped

C. The hreflang tags are not self-closing

D. The en tag should not be included when region-specific tags exist

Solution

1. Step 1: Understand the role of x-default hreflang

   The x-default tag tells search engines which page to show when no exact language-region match is found.

2. Step 2: Identify missing x-default causing fallback issues

   Without x-default, search engines may default to the wrong page, like showing US instead of UK for UK users.

3. Final Answer:

   The hreflang tags are missing the x-default tag -> Option A

4. Quick Check:

   Missing x-default causes wrong fallback page [OK]

Hint: Always add x-default for fallback page [OK]

Common Mistakes:

• Swapping URLs without checking content
• Ignoring importance of x-default
• Thinking self-closing tags affect hreflang behavior

5. You manage a website with English, French, and Spanish versions. You want to target users in Canada who speak English and French, and users in Spain who speak Spanish. Which hreflang tags should you use to correctly target these audiences?

hard

A.

B.

C.

D.

Solution

1. Step 1: Match language and region codes to target audiences

   Canada English is "en-CA", Canada French is "fr-CA", and Spain Spanish is "es-ES". These codes precisely target the intended users.

2. Step 2: Include x-default for fallback

   The x-default tag provides a default page for users not matching any specific hreflang, improving user experience and SEO.

3. Final Answer:

   Use hreflang tags with en-CA, fr-CA, es-ES, and x-default for fallback -> Option D

4. Quick Check:

   Use language-region codes + x-default for precise targeting [OK]

Hint: Use language-region codes plus x-default for fallback [OK]

Common Mistakes:

• Using generic language codes without region
• Mixing up region codes (e.g., US instead of CA)
• Omitting x-default tag