Multi-locale fallback-ketens instellen in een headless CMS

Je hebt je site eerst in het Engels gelanceerd en zes maanden later Frans en Duits toegevoegd. De vertalingen zijn voor 80% klaar, wat betekent dat 20% van je pagina's lege velden toont in niet-Engelse locales. Een fallback-keten lost dit op: als een veld geen Franse vertaling heeft, geeft ContentGrid de Engelse waarde terug in plaats van null. Je site blijft compleet terwijl redacteuren bijwerken.

Hoe locale fallbacks werken

ContentGrid slaat per locale een aparte waarde op voor elk veld. Als je een veld opvraagt met een opgegeven locale, controleert ContentGrid het veld eerst in die locale. Als de waarde leeg of ontbrekend is, loopt het de fallback-keten af totdat het een niet-lege waarde vindt. De keten is per locale configureerbaar, zodat Frans kan terugvallen op Engels terwijl Duits terugvalt op Frans en daarna op Engels.

• Primaire locale: fr-FR — als eerste gecontroleerd.
• Eerste fallback: en-US — gebruikt als het Franse veld leeg is.
• Geen tweede fallback nodig voor een tweetalige site.

Voor grotere setups kun je pt-BR → pt-PT → en-US gebruiken om beide Portugese varianten te dekken.

Fallbacks configureren in ContentGrid

Ga in het ContentGrid-dashboard naar Instellingen → Locales. Voor elke ingeschakelde locale kun je via een dropdown een fallback-locale instellen. De volgorde is belangrijk — ContentGrid loopt de keten af in de volgorde die je definieert. Sla de configuratie op en deze wordt direct van kracht op alle API-responses.

Je kunt dit ook instellen via de Management API als je je configuratie als code beheert:

• Stuur een PATCH-verzoek naar /api/locales/fr-FR met een body die { fallback: "en-US" } bevat.
• Herhaal dit voor elke locale die een fallback nodig heeft.
• Leg je locale-configuratie vast in je infrastructure-as-code-repository zodat het reproduceerbaar is.

Gelokaliseerde content ophalen vanuit Next.js

Geef bij het ophalen van content uit ContentGrid in je Next.js-app de locale mee vanuit de router:

• Gebruik params.lang (of router.locale in oudere setups) om de huidige locale op te halen.
• Geef deze mee als header of queryparameter aan de ContentGrid SDK: client.entries({ locale: params.lang }).
• ContentGrid past de fallback-keten server-side toe en geeft voor elk veld de best beschikbare waarde terug.
• Je hoeft geen fallback-logica te schrijven in je applicatiecode — de API regelt het.

Locale-specifieke slugs afhandelen

Slugs zijn een veelvoorkomende uitzondering. Als je Franse URL /fr/produit/ergonomische-stoel is en de Engelse URL /en/product/ergonomic-chair, zijn dat verschillende strings — fallback geldt voor slugs niet op dezelfde manier. Sla slugs op als locale-specifieke velden en gebruik geen fallback. Redirect voor pagina's met ontbrekende slugs op routerniveau naar de Engelse versie in plaats van te vertrouwen op CMS-fallback.

Fallback-ketens zijn het nuttigst voor bodytekst, metabeschrijvingen en veldwaarden die tijdelijk in een andere taal getoond mogen worden. Slugs, datums en valutawaarden hebben locale-specifieke behandeling nodig. Dit onderscheid houdt je contentmodel overzichtelijk en je URL's correct.