How to enable multilingual content in Builder.io Headless CMS
In this guide, you will learn how to implement multilingual content in Builder.io Headless CMS with clear instructions!
To manage and publish localized (multilingual) content with Builder.io Headless CMS, you need at least a Pro subscription ($39/month), which unlocks the Localization functionality.

1. Allow multiple URLs
- Select Settings
- Select Advanced Settings
- Check Allow targeting to multiple URLs


2. Enable Localization in your account settings
- Go to Settings → Space tab.
- Choose Targeting → Localization → Edit .
- Add the desired language version by typing its locale code, e.g. fi-FI or sv-SE , and press Enter .
- Finally, click Save Changes .

3. Add a Dynamic Preview URL to make different language versions work in preview
This allows the preview to work in different language versions. This does not affect the presentation of the online store content - but rather the way the Builderion editor works in different language versions.
- Go to the Content tab and select Content Models → e.g. Page .
- Click <> Edit dynamic preview URL and add the corresponding code (just replace your domain names and add country codes if necessary):
const rawPath = targeting.urlPath || '';
const path = rawPath.startsWith('/') ? rawPath : `/${rawPath}`;
const language = locale || ''
switch (language) {
case 'sv-se':
return "https://trafino.se" + path
case 'fi-FI':
return "https://trafino.fi" + path
default:
return "https://trafino.com" + path
}

3. Activate the Localize setting for fields (e.g. Title and Meta description)
- Go to the Content Models section and open the desired model (e.g. Page ).
- Select the Fields tab.
- Click on a field such as Title or Meta Description .
- Turn on the Localize setting for these fields.
This allows you to edit titles and meta descriptions for different language versions.

4. Create and build content
- Go to the Content tab.
- Select a language from the Locale menu (for example, initially fi-FI) .
Attention
The default selection “ Default” is not an actual language version and should not be used.
Create a new page or edit an existing one. Make sure all components are added under the fi-FI locale.


Open Targeting and add all URL paths where the content will be displayed on different domains. Do not add any other conditions!

5. Create content in all languages
Click on the globe icons and translate the content into different languages. You can also use different images for different languages. Remember that the “Default” language is not used.

6. Publish and test
Click Publish and test in the preview that the language versions work correctly according to the selected domain and localized URL.