{"id":1512,"date":"2026-06-19T13:00:00","date_gmt":"2026-06-19T18:00:00","guid":{"rendered":"https:\/\/tolinku.com\/blog\/?p=1512"},"modified":"2026-03-07T03:49:30","modified_gmt":"2026-03-07T08:49:30","slug":"hreflang-app-deep-links","status":"publish","type":"post","link":"https:\/\/tolinku.com\/blog\/hreflang-app-deep-links\/","title":{"rendered":"Hreflang for App Deep Links: International SEO"},"content":{"rendered":"\n

If your app serves multiple languages or regions, search engines need to know which version of each page to show to which audience. That is what hreflang<\/a> does. Without it, Google may show the English version of your product page to a French user, or the US-priced listing to someone in Germany.<\/p>\n\n\n\n

For apps with deep links, hreflang adds another layer: you need to coordinate the web page language variants with the app deep link targets. This guide covers how to do that correctly. For the general app indexing strategy, see app indexing and SEO for mobile apps<\/a>. For canonical URL strategy across app content, see canonical URLs for app content<\/a>.<\/p>\n\n\n\n

How Hreflang Works<\/h2>\n\n\n\n

The Basics<\/h3>\n\n\n\n

Hreflang tells search engines: "This page exists in multiple language\/region versions. Here are the URLs for each version." Google then serves the correct version based on the searcher's language and location.<\/p>\n\n\n\n

<head>\n  <link rel="alternate" hreflang="en" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n  <link rel="alternate" hreflang="es" href="https:\/\/www.yourapp.com\/es\/products\/shoes" \/>\n  <link rel="alternate" hreflang="fr" href="https:\/\/www.yourapp.com\/fr\/products\/shoes" \/>\n  <link rel="alternate" hreflang="de" href="https:\/\/www.yourapp.com\/de\/products\/shoes" \/>\n  <link rel="alternate" hreflang="x-default" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n<\/head>\n<\/code><\/pre>\n\n\n\n
The x-default<\/code> value specifies the fallback version for users whose language\/region does not match any listed variant.<\/p>\n\n\n\n
Language vs. Region<\/h3>\n\n\n\n
Hreflang supports both language-only and language-region codes:<\/p>\n\n\n\n
\n\n\n\n\n\n\n\n\n
Code<\/th>\nMeaning<\/th>\n<\/tr>\n<\/thead>\n
en<\/code><\/td>\nEnglish (any region)<\/td>\n<\/tr>\n
en-US<\/code><\/td>\nEnglish for United States<\/td>\n<\/tr>\n
en-GB<\/code><\/td>\nEnglish for United Kingdom<\/td>\n<\/tr>\n
es<\/code><\/td>\nSpanish (any region)<\/td>\n<\/tr>\n
es-MX<\/code><\/td>\nSpanish for Mexico<\/td>\n<\/tr>\n
pt-BR<\/code><\/td>\nPortuguese for Brazil<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n\n\n
Use language-region codes when the content differs by region (pricing, availability, legal terms). Use language-only codes when all regions share the same translation.<\/p>\n\n\n\n
URL Structures for Multilingual Deep Links<\/h2>\n\n\n\n
Option 1: Subdirectory per Language<\/h3>\n\n\n\n
https:\/\/www.yourapp.com\/products\/shoes          (English, default)\nhttps:\/\/www.yourapp.com\/es\/products\/shoes       (Spanish)\nhttps:\/\/www.yourapp.com\/fr\/products\/shoes       (French)\nhttps:\/\/www.yourapp.com\/de\/products\/shoes       (German)\n<\/code><\/pre>\n\n\n\n
This is the simplest approach. All content lives on one domain, preserving link equity. The deep link path includes the language prefix.<\/p>\n\n\n\n
App deep link handling:<\/strong><\/p>\n\n\n\n
\/\/ iOS: Extract language from URL path\nfunc handleDeepLink(_ url: URL) {\n    let pathComponents = url.pathComponents\n    let supportedLanguages = ["es", "fr", "de", "ja", "ko"]\n\n    var language = "en"\n    var contentPath = url.path\n\n    if pathComponents.count > 1, supportedLanguages.contains(pathComponents[1]) {\n        language = pathComponents[1]\n        contentPath = "\/" + pathComponents.dropFirst(2).joined(separator: "\/")\n    }\n\n    setAppLanguage(language)\n    navigateToContent(contentPath)\n}\n<\/code><\/pre>\n\n\n\n
Option 2: Separate Domains per Region<\/h3>\n\n\n\n
https:\/\/www.yourapp.com\/products\/shoes          (US)\nhttps:\/\/www.yourapp.co.uk\/products\/shoes        (UK)\nhttps:\/\/www.yourapp.de\/products\/shoes           (Germany)\nhttps:\/\/www.yourapp.com.br\/products\/shoes       (Brazil)\n<\/code><\/pre>\n\n\n\n
Each domain needs its own App Links<\/a> and Universal Links<\/a> verification files. This multiplies the configuration work.<\/p>\n\n\n\n
Option 3: Subdomain per Language<\/h3>\n\n\n\n
https:\/\/en.yourapp.com\/products\/shoes\nhttps:\/\/es.yourapp.com\/products\/shoes\nhttps:\/\/fr.yourapp.com\/products\/shoes\n<\/code><\/pre>\n\n\n\n
Similar to separate domains in terms of verification complexity. Each subdomain needs its own assetlinks.json<\/code> and apple-app-site-association<\/code> files.<\/p>\n\n\n\n
Recommendation:<\/strong> Use subdirectories unless you have strong business reasons for separate domains (different legal entities, separate app builds per region).<\/p>\n\n\n\n
Hreflang Implementation for Deep Link Pages<\/h2>\n\n\n\n
HTML Link Tags<\/h3>\n\n\n\n
Add hreflang tags to every language variant of each page:<\/p>\n\n\n\n
<!-- On https:\/\/www.yourapp.com\/products\/shoes -->\n<head>\n  <link rel="alternate" hreflang="en" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n  <link rel="alternate" hreflang="es" href="https:\/\/www.yourapp.com\/es\/products\/shoes" \/>\n  <link rel="alternate" hreflang="fr" href="https:\/\/www.yourapp.com\/fr\/products\/shoes" \/>\n  <link rel="alternate" hreflang="x-default" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n  <link rel="canonical" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n<\/head>\n\n<!-- On https:\/\/www.yourapp.com\/es\/products\/shoes -->\n<head>\n  <link rel="alternate" hreflang="en" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n  <link rel="alternate" hreflang="es" href="https:\/\/www.yourapp.com\/es\/products\/shoes" \/>\n  <link rel="alternate" hreflang="fr" href="https:\/\/www.yourapp.com\/fr\/products\/shoes" \/>\n  <link rel="alternate" hreflang="x-default" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n  <link rel="canonical" href="https:\/\/www.yourapp.com\/es\/products\/shoes" \/>\n<\/head>\n<\/code><\/pre>\n\n\n\n
Every page must reference all other language variants, including itself. This bidirectional confirmation is how Google validates the hreflang setup.<\/p>\n\n\n\n
Sitemap Implementation<\/h3>\n\n\n\n
For large apps with thousands of pages, implementing hreflang in sitemaps is more maintainable than HTML tags:<\/p>\n\n\n\n
<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http:\/\/www.sitemaps.org\/schemas\/sitemap\/0.9"\n        xmlns:xhtml="http:\/\/www.w3.org\/1999\/xhtml">\n  <url>\n    <loc>https:\/\/www.yourapp.com\/products\/shoes<\/loc>\n    <xhtml:link rel="alternate" hreflang="en" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n    <xhtml:link rel="alternate" hreflang="es" href="https:\/\/www.yourapp.com\/es\/products\/shoes" \/>\n    <xhtml:link rel="alternate" hreflang="fr" href="https:\/\/www.yourapp.com\/fr\/products\/shoes" \/>\n    <xhtml:link rel="alternate" hreflang="x-default" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n  <\/url>\n  <url>\n    <loc>https:\/\/www.yourapp.com\/es\/products\/shoes<\/loc>\n    <xhtml:link rel="alternate" hreflang="en" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n    <xhtml:link rel="alternate" hreflang="es" href="https:\/\/www.yourapp.com\/es\/products\/shoes" \/>\n    <xhtml:link rel="alternate" hreflang="fr" href="https:\/\/www.yourapp.com\/fr\/products\/shoes" \/>\n    <xhtml:link rel="alternate" hreflang="x-default" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n  <\/url>\n<\/urlset>\n<\/code><\/pre>\n\n\n\n
Deep Link Routing by Language<\/h2>\n\n\n\n
Server-Side Language Detection<\/h3>\n\n\n\n
When a deep link URL is accessed, detect the user's language and route accordingly:<\/p>\n\n\n\n
app.get('\/products\/:slug', (req, res) => {\n  const acceptLanguage = req.headers['accept-language'];\n  const userLang = parseLanguage(acceptLanguage); \/\/ e.g., 'es'\n  const localizedPath = userLang !== 'en' ? `\/${userLang}\/products\/${req.params.slug}` : req.path;\n\n  \/\/ For app users: deep link opens the localized content\n  \/\/ For web users: redirect to the localized page\n  if (isBot(req.headers['user-agent'])) {\n    \/\/ Serve the English version to bots (they follow hreflang for other versions)\n    renderPage(req.params.slug, 'en', res);\n  } else {\n    res.redirect(302, localizedPath);\n  }\n});\n<\/code><\/pre>\n\n\n\n
App-Side Language Handling<\/h3>\n\n\n\n
When the app opens a deep link, use the URL's language prefix to set the content language:<\/p>\n\n\n\n
\/\/ Android: handle localized deep links\nclass ProductActivity : AppCompatActivity() {\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n\n        val uri = intent.data ?: return\n        val pathSegments = uri.pathSegments\n\n        \/\/ Check if first segment is a language code\n        val supportedLangs = setOf("es", "fr", "de", "ja", "ko", "pt")\n        val lang = if (pathSegments.isNotEmpty() && supportedLangs.contains(pathSegments[0])) {\n            pathSegments[0]\n        } else {\n            "en"\n        }\n\n        val slug = pathSegments.last()\n        viewModel.loadProduct(slug, lang)\n    }\n}\n<\/code><\/pre>\n\n\n\n
Structured Data for Multilingual Content<\/h2>\n\n\n\n
Localized Structured Data<\/h3>\n\n\n\n
Each language variant should have its own structured data with localized values:<\/p>\n\n\n\n
<!-- English version -->\n<script type="application\/ld+json">\n{\n  "@context": "https:\/\/schema.org",\n  "@type": "Product",\n  "name": "Running Shoes",\n  "description": "Lightweight running shoes for daily training",\n  "offers": {\n    "@type": "Offer",\n    "price": "120.00",\n    "priceCurrency": "USD"\n  },\n  "potentialAction": {\n    "@type": "ViewAction",\n    "target": "https:\/\/www.yourapp.com\/products\/running-shoes"\n  }\n}\n<\/script>\n\n<!-- Spanish version -->\n<script type="application\/ld+json">\n{\n  "@context": "https:\/\/schema.org",\n  "@type": "Product",\n  "name": "Zapatillas de Running",\n  "description": "Zapatillas ligeras para entrenamiento diario",\n  "offers": {\n    "@type": "Offer",\n    "price": "110.00",\n    "priceCurrency": "EUR"\n  },\n  "potentialAction": {\n    "@type": "ViewAction",\n    "target": "https:\/\/www.yourapp.com\/es\/products\/running-shoes"\n  }\n}\n<\/script>\n<\/code><\/pre>\n\n\n\n
Common Mistakes<\/h2>\n\n\n\n
Missing Return Links<\/h3>\n\n\n\n
Every hreflang annotation must be bidirectional. If page A says "my Spanish version is page B," page B must say "my English version is page A." If either side is missing, Google ignores the entire hreflang relationship for that pair.<\/p>\n\n\n\n
Conflicting Canonical and Hreflang<\/h3>\n\n\n\n
Do not set the canonical URL of a localized page to the default language version. Each language variant should have its own self-referencing canonical:<\/p>\n\n\n\n
<!-- Wrong: Spanish page canonicalized to English -->\n<link rel="canonical" href="https:\/\/www.yourapp.com\/products\/shoes" \/>\n\n<!-- Correct: Spanish page canonicalized to itself -->\n<link rel="canonical" href="https:\/\/www.yourapp.com\/es\/products\/shoes" \/>\n<\/code><\/pre>\n\n\n\n
Missing x-default<\/h3>\n\n\n\n
Always include x-default<\/code> to handle users whose language\/region does not match any variant. Without it, Google guesses which version to show.<\/p>\n\n\n\n
Tolinku and International Deep Links<\/h2>\n\n\n\n
Tolinku<\/a> supports deep link routing with path-based rules. Configure routes like \/:lang\/products\/:slug<\/code> in the Tolinku dashboard<\/a> to handle localized deep links. The route parameters pass the language code to the app, which loads the content in the correct language.<\/p>\n\n\n\n
For banner localization on multilingual sites, see localizing smart banners<\/a>. For the broader app indexing strategy, see app indexing and SEO for mobile apps<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Handle international SEO for app deep links. Use hreflang tags to serve the right app content for different languages and regions.<\/p>\n","protected":false},"author":2,"featured_media":1511,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"Hreflang for App Deep Links: International SEO","rank_math_description":"Handle international SEO for app deep links. Use hreflang tags to serve the right app content for different languages and regions.","rank_math_focus_keyword":"hreflang app deep links","rank_math_canonical_url":"","rank_math_facebook_title":"","rank_math_facebook_description":"","rank_math_facebook_image":"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/og-hreflang-app-deep-links.png","rank_math_facebook_image_id":"","rank_math_twitter_title":"","rank_math_twitter_description":"","rank_math_twitter_image":"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/og-hreflang-app-deep-links.png","footnotes":""},"categories":[16],"tags":[20,382,383,248,69,384,358,63],"class_list":["post-1512","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-marketing","tag-deep-linking","tag-hreflang","tag-international-seo","tag-localization","tag-mobile-development","tag-multilingual","tag-search","tag-seo"],"_links":{"self":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts\/1512","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/comments?post=1512"}],"version-history":[{"count":4,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts\/1512\/revisions"}],"predecessor-version":[{"id":2620,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts\/1512\/revisions\/2620"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/media\/1511"}],"wp:attachment":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/media?parent=1512"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/categories?post=1512"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/tags?post=1512"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}