Näin otat käyttöön monikielisen sisällön Builder.io Headless CMS:ssä
Sisällysluettelo
Jotta voit hallita ja julkaista lokalisoitua (monikielistä) sisältöä Builder.io Headless CMS:llä, tarvitset vähintään Pro-tilauksen ($39/kk), joka avaa käyttöösi Localization-toiminnallisuuden.

1. Ota Localization käyttöön tilin asetuksista
- Siirry Settings (Asetukset) → Space-välilehdelle.
- Valitse Targeting → Localization → Edit.
- Lisää haluamasi kieliversio kirjoittamalla sen locale-koodi, esim. fi-FI tai sv-SE, ja paina Enter.
- Klikkaa lopuksi Save Changes.

2. Lisää Dynamic Preview URL, jotta eri kieliversiot toimivat esikatselussa
- Siirry Content-välilehdelle ja valitse Content Models → esim. Page.
- Klikkaa <> Edit dynamic preview URL ja lisää seuraava koodi:
const rawPath = targeting.urlPath || '';
const path = rawPath.startsWith('/') ? rawPath : `/${rawPath}`;
if (locale === 'sv-SE') {
return `https://trafino.se${path}`;
} else {
return `https://trafino.fi${path}`;
}
Tämä mahdollistaa esikatselun toiminnan eri kieliversioissa oikean domainin alla.


3. Aktivoi Localize-asetus kentille (esim. Title ja Meta description)
Siirry Content Models -osioon ja avaa haluamasi malli (esim. Page).
Valitse Fields-välilehti.
Klikkaa kenttää kuten Title tai Meta Description.
Laita päälle Localize-asetus näille kentille.
Tämä mahdollistaa eri kieliversioiden otsikoiden ja meta-kuvausten muokkaamisen.

4. Luo ja rakenna suomenkielinen sisältö (fi-FI)
Siirry Content-välilehdelle.
Valitse Locale-valikosta fi-FI.
Huom: Oletusvalinta Default ei ole varsinainen kieliversio, eikä sitä tule käyttää.
Luo uusi sivu tai muokkaa olemassa olevaa. Varmista, että kaikki komponentit lisätään fi-FI-localen alle.


Avaa Targeting ja lisää URL:lle fi-FI-locale, jotta selain tietää esittää suomenkielistä sisältöä Suomessa.

5. Luo toinen kieliversio (esim. ruotsi / sv-SE)
Kopioi suomenkielinen sivu Content-välilehdeltä.

Avaa kopioitu sivu.
Default-näkymässä muuta Title ruotsinkieliseksi, jotta erotat sivut toisistaan sisällönhallinnassa. Älä tee muita muutoksia default-näkymässä.
Vaihda Locale-asetukseksi sv-SE ja lisää:
- Otsikko ja meta-kuvaus ruotsiksi
- Targeting-osiossa lokalisoitu URL-osoite ja Locale sv-SE

Käännä kaikki sivun komponentit yksi kerrallaan ruotsiksi.
Huom: Sisältö voi poiketa maittain – se ei tarvitse olla identtinen.
6. Julkaise ja testaa
Klikkaa Publish ja testaa esikatselussa, että kieliversiot toimivat oikein valitun domainin ja lokalisoidun URL:n mukaisesti.