Skip to main content

Multilingual Content

Reach global audiences. LusterCMS has built-in internationalization (i18n) support for managing content in multiple languages.

Features

🌍 Language Management

  • Unlimited languages — Add as many as you need
  • RTL support — Right-to-left languages (Arabic, Hebrew)
  • Locale variants — en-US, en-GB, pt-BR, etc.

📝 Translation Workflow

  • Side-by-side editing — View source and translation together
  • Translation status — Track what's translated
  • AI translation — BlueBird helps translate content
  • Import/export — Work with external translation services

🔗 URL Structure

Choose your URL strategy:

StrategyExample
Subdirectoryexample.com/es/page
Subdomaines.example.com/page
Query paramexample.com/page?lang=es

Setting Up Languages

Add a Language

  1. Go to Settings → Languages
  2. Click Add Language
  3. Select language and locale
  4. Set as default if needed

Configure Fallbacks

Set what happens when translation is missing:

  • Show default language — Display primary content
  • Show 404 — Return not found
  • Redirect — Send to default language

Translating Content

Manual Translation

  1. Open content in the editor
  2. Click the Language dropdown
  3. Select target language
  4. Translate fields

AI Translation

  1. Select content to translate
  2. Click AI Translate
  3. Choose target language
  4. Review and edit result

Bulk Translation

  1. Go to Content → [Type]
  2. Select multiple items
  3. Click Translate
  4. Choose languages

Translation Status

Track progress with status indicators:

StatusMeaning
🟢 TranslatedUp to date
🟡 OutdatedSource changed since translation
🔴 MissingNo translation exists

API Access

Query content by language:

query GetPage {
entry(slug: "about", locale: "es") {
title
content
locale
}
}

Best Practices

  1. Start with structure — Define languages before creating content
  2. Use AI wisely — AI translation is a starting point, not final
  3. Track status — Keep translations up to date
  4. Test thoroughly — Check RTL layouts, character encoding

💡 Pro Tip

Use the translation status dashboard to see all content that needs translation at a glance.