Basker Docs

Languages and translation

Add languages to your site and manage translations across pages, events, posts, and other content

Basker supports running your site in more than one language. You enable the languages you need at the site level, and from then on any field that accepts translations can be filled in once per language.

How languages work in Basker

A site has one default language and zero or more additional languages. The default language is a fallback: if a field hasn't been translated, visitors browsing the site in another language see the default-language version of that field.

Most user-facing fields support translation — page titles, descriptions, content blocks, event details, post bodies, SEO metadata, and so on. A handful of structural fields (URL slugs, internal references, settings) stay the same across all languages.

Adding a language to your site

Open Settings → Languages. The screen is subtitled Manage your site's multilingual support and shows your Available Languages as cards, with Default and Enabled badges on the languages that have them.

Add the language you want from the available set. Once added, every translatable field on every record gains a tab or selector for the new language.

Adding a language doesn't translate anything for you — it makes new translation fields available to be filled in. Existing content carries on showing in the default language until you fill in the translation.

Translating a record

Open the record you want to translate. Each translatable field shows a language switcher. Switch to the new language and enter the translated content. Save normally.

You can translate as many or as few fields as you need. Untranslated fields fall back to the default language. This means partial translation is fine — Basker doesn't block you from publishing a partly-translated record.

How visitors choose a language

Your theme decides how visitors switch language on the live site. Most themes provide a language switcher in the header or footer, and remember the visitor's choice across pages.

For developer-level information about how a theme handles language selection, see basker.dev.

Removing a language

You can remove a language from a site. Translated content for that language stays in your version history but no longer appears on the live site. Re-adding the language brings the translations back.

Where to go next

On this page