FREEFirst project with us? Your landing page design is on the house.See the offer

SEO and AEO

International SEO: subfolders, hreflang and what breaks

Which URL structure to pick for more countries, how hreflang works with a worked example, and a table of what breaks most often and how to fix it.

By Abdul QuadirUpdated 2026-09-266 min read
TL;DR
  • For most marketing sites, subfolders such as /de/ are the simple choice: easy to set up, low upkeep, one domain.
  • Every version must list itself and every other version, with full URLs. If two pages do not point at each other, Google ignores the tags.
  • A translated page should have its own canonical. Pointing it at the main language is a common way to lose it.
  • Do not redirect by IP or assumed language. Link to the other versions so people and crawlers can reach them all.
  • Translate the main content, not only the menu. Google treats pages as duplicates if only the header and footer change.

The short answer

For most marketing sites, use subfolders such as example.com/de/, add hreflang tags to every version, give each version its own canonical, and link between versions in place of automatic redirects. Translate the main content of each page. Most international problems come from breaking one of those rules, and every one can be checked.

The two Google pages to read are localised versions of your pages and managing multi-regional sites. If you are on Webflow, our Webflow Localization guide covers the setup in detail.

Choosing a URL structure

This table summarises the trade-offs Google lists, with our rule in the last column.

StructureGoodCostsOur rule
Subfolder: example.com/de/Easy to set up, low upkeepOne server location, sites are less separatedThe default for most marketing sites
Subdomain: de.example.comEasy to set up, can use other serversPeople cannot tell if "de" is a language or a countryWhen a local team runs its own stack
Country domain: example.deClear country signalCostly, more infrastructure, some have strict rules, one country onlyWhen a country is a real business of its own
Parameter: site.com?loc=deNone worth havingGoogle does not recommend itDo not use

Whichever you pick, keep it for the whole site. Mixing structures makes the tags and reports harder to manage. See also subdomain vs subfolder.

Language or country?

Decide what you are targeting before you make any URLs.

  • Different language: a page per language, such as /de/ and /fr/. This is the common case.
  • Same language, different market: make /en-gb/ and /en-us/ only when something real differs, such as prices, delivery, legal text or proof.

Google says language versions count as duplicates only if the main content is in the same language. So two English pages with the same text are duplicates. If you keep both, Google advises choosing a preferred version with canonical and hreflang tags. If nothing real differs, keep one page.

How hreflang works, with an example

Say you have a pricing page in English and German, with English as your fallback. Both pages carry this same set of tags:

  • <link rel="alternate" hreflang="en" href="https://example.com/pricing" />
  • <link rel="alternate" hreflang="de" href="https://example.com/de/pricing" />
  • <link rel="alternate" hreflang="x-default" href="https://example.com/pricing" />

The rules, from Google:

  • Self reference. Each version lists itself as well as all the others.
  • Return links. If page A points to B, B must point back to A. If they do not, the tags are ignored.
  • Full URLs. Include https://. A path such as /de/pricing does not qualify.
  • Codes. A language, with an optional region: de or en-GB. A country alone is invalid. be means Belarusian, not Belgium.
  • One method. Page tags, HTTP headers or the XML sitemap. Using more than one brings no Search benefit.
  • x-default is the fallback when no listed language matches. It suits a language selector page or your main version.

Google also says it does not use hreflang or the HTML lang attribute to work out a page's language. It reads the page itself, so the content must really be in that language. Keep your lang attribute correct anyway, for screen readers and browsers.

What breaks most often

What goes wrongWhat happensFix
Page A points to B, B does not point backGoogle ignores the tagsGenerate the whole set from one list of locales
Relative URLs in the tagsThey do not qualifyUse the full URL with https
Canonical on /de/ points to the English pageYou are telling Google to prefer the English pageEach language version gets a canonical to itself
Only menus and footer are translatedGoogle treats the pages as duplicatesTranslate the main content, or do not publish that page yet
Redirect by IP or browser languagePeople and crawlers can miss versionsLink to versions, and let people choose
en-UK used as a codeGoogle ignores reserved codes such as UK and EUUse en-GB
Tags point to redirects, noindex pages or 404sIn our view, a broken signalCheck every target returns 200 and is indexable
Two languages on one pageGoogle advises one language per pagePick one for the content and the navigation
A translated slug changes with no redirectThe old URL diesAdd a 301 redirect

Redirects and the language switcher

Google advises against sending people to another version based on their assumed language, because this can stop people and search engines from seeing all your versions. It also says not to adapt content by IP: location checks are unreliable, most crawling comes from the US, and Google does not vary where it crawls from. A German page shown only to German IPs may never be seen at all.

So link the versions together:

  • A language switcher on every page, using real links, going to the same page in the other language.
  • If you want to help people, show a small banner suggesting their language, without moving them.
  • Label each language in its own language: Deutsch, not German.

Local signals beyond translation

Google lists local addresses and phone numbers, local language and currency, and links from local sites among the signals it reads. These also help the person reading the page.

  • Prices and currency where you really can bill that way. Say plainly what you bill in. Our note on the currency we bill in is one example.
  • Proof that fits the market, only if it is true.
  • Forms and routing. A lead in German should reach someone who can reply in German.
  • Consent and legal pages. Rules differ by country. This post is not legal advice, so ask someone qualified for each market.

Doing it in Webflow and Astro

Webflow. Localization puts each secondary locale in its own subfolder on the same domain and can generate hreflang tags for you. It is a paid add-on, and details change, so check the current Webflow docs. Our guide has a launch checklist, and Webflow development is where we build it.

Astro. You control the HTML, so keep one list of locales in code and generate tags, canonicals and the switcher in the layout from that list. A page that lists its alternates from one source is far less likely to lose a return link. See Astro and Sanity.

A check before each new locale

  1. Main content is translated and read by someone who speaks the language.
  2. Titles, descriptions, image alt text and slugs are translated.
  3. Tags on a sample of pages list every version, including itself, in full URLs.
  4. Each version has a canonical to itself.
  5. Every tag target returns 200 and is indexable.
  6. The sitemap includes the new URLs.
  7. The switcher goes to the same page, not the home page.
  8. Forms reach the right person.
  9. Search Console: filter pages by your folder, such as /de/, and watch them over time.

What to do next

Start with one market, and check that you can answer a lead in that language before you translate anything. Build the tags from one list so they cannot drift apart, then run the check above. If you want help, see SEO and AEO or send us your site. We can set this up properly, but we cannot promise rankings in any market.

Abdul Quadir
Abdul QuadirFounder of Kookies. Builds Webflow and Astro sites for startups and growing teams.

Terms used: Hreflang, Webflow

FAQs

Questions
people ask.

Abdul Quadir
Still have a question?Ask us directly. We reply within a day.
Book a callPick a timehello@kookies.io

Google lists trade-offs for each and does not name a winner. Subfolders are easy to set up and low upkeep, which is why we use them by default on marketing sites.

A tag that tells Google which language or region each version of a page is for, so it can show people the right one. Every version lists itself and all the others.

The most common reason is missing return links. If two pages do not point at each other, Google ignores the tags. Also check for relative URLs and invalid codes.

No. Each language version should have a canonical to itself. Google treats language versions as duplicates only if the main content is in the same language.

Google advises against it, because people and crawlers may then miss versions. Link to the other versions and let people choose.

The fallback page for people whose language settings match none of your listed versions. It often points to a language selector or your main version.

Your turn

Let's kook
what you krave.

Hi Kookies, I need a built on . I'd love to launch . Reach me at
or book a callSent. We reply within one working day.