Language prefix in URL with correct entry URIs

Question

I never used Craft before and I'm trying to create a multi-language site (in headless mode) but am running into problems with adding the language to the URL.

My goal is to have URLs that always start with the language, e.g. /en/page and /de/seite. I started by adding that prefix to the base URL of each language site which works fine for querying URLs but not for URIs. I could manually prepend the language to each link but that seems wrong...

What is the recommended way of adding such a language prefix?

• Adding the prefix to each language site (manually adding the prefix to each link)
• Adding the prefix to every section (manually adding the prefix for each section).

Answer 1

You include the language prefix in each site's URL setting as per the documentation. It's fine that URIs of entries don't include the site URL, this way they stay language-independent. You wouldn't want to have to update all URIs if you need to change the base URL of one site.

If you create site URLs as intended, you will never notice that the language prefix / base URL is added on the fly:

• For elements: Use Element::getUrl (e.g. entry.getUrl() in Twig)
• For custom links: Use the siteUrl function.