Clear CMS Docs 2026

Languages

Write your site in more than one language: add a language, fill it in by hand, as a copy or with AI help, and edit each language in the page editor and in records.

On this page

Your site can speak more than one language. Each language has the same pages and records, with words of its own. You add languages in Settings, fill them in by hand, as a copy or with AI help, and edit each one in the page editor and in records.

How languages work

  • The first language in your list (marked Default in Settings → Languages) is the one your site opens in. Visitors get it at your plain addresses, like /menu. New pages and records start in it, and it fills in wherever another language has no text yet.
  • Every other language has its code in front of the address: /uk/menu for Ukrainian.
  • On a site drawn by Clear (a Clear Blocks site), visitors switch language with a switch in the site's header (or its top bar), which appears once there are two languages or more. On a site with its own code, that code draws the switch.

Add a language

You need the Admin or Owner role.

  1. Press Settings, then Languages (under Site).
  2. Press Add a language at the top right.
  3. Find it with Find a language, and pick it.
  4. Clear says what your first language has that the new one doesn't yet: so many pages, records, menus and forms, and how many words. Choose how the new language starts:
    • Start empty: nothing is copied. Where it has no text, visitors see your first language.
    • Copy the English text: every empty text starts as a copy, ready to be rewritten.
    • Translate automatically: the site's AI writes a first version for you to check. It says how many AI answers it uses. See Translate with AI.
  5. For a copy or a translation, tick what to fill: Pages, Records, Menus and forms.
  6. What will happen sums it up. Press Add Ukrainian (or Add and copy, Add and translate).

A copy or a translation runs page by page, and you can Stop it. What is done stays done: run it again later and it takes up only what is still missing. Everything is saved as drafts, and text already written in the language is never changed. Read it through, then publish from All changes.

Records in collections that go live right away are left out: fill those in by hand, in each record.

Add a language: start empty, copy the first language's text, or translate it with AI

The language list

Settings → Languages lists your languages in order, each with its code, its name and its own name (Українська).

  • The first has the Default chip.
  • Every other language shows how much is done, like "12 of 14 pages, 30 of 31 records", and how many texts are still the same as the first language.
  • Shown to visitors or Hidden from visitors: a switch for each language but the first.
  • ⋯ beside a language: Fill in what is missing (copy or translate the gaps, as when adding), Make default, Move up, Move down and Remove.
Settings → Languages: the default language first, then how far along each other language is

The list saves as soon as you change it.

Make another language the default

  1. Press ⋯ beside it, then Make default.
  2. Clear asks Make Ukrainian the default? Press Make default.

New pages and records then start in it, and it fills in wherever another language has no text. No text is changed.

Edit in another language

The language you edit in is one choice per site, remembered in your browser. A site you haven't edited before opens in its first language. Change it in any of these places and the others follow: the page editor, its preview and your records all show the same language.

  • In the page editor: the language menu at the top right, beside Preview. It shows the language's name, or its two-letter code on a narrower window, and is tinted while you edit a language other than the first. Pick a language and the preview shows the page in it. The menu marks the First language.
  • In a record: the language menu in the record's bar.
  • Anywhere else: your name at the bottom of the left menu, then Edit in.
The page editor's language menu: the preview shows the language you pick

The language menu and the preview always agree. Use the site's own language switch inside the preview, while editing or viewing as a visitor, and the menu follows.

What you type goes only into the language you are editing: the words in your other languages stay as they are.

Fill in a record

In a record, pick the language from its menu. A field with no text in that language shows your first language's text in grey, with Not in Ukrainian yet under it:

  • Copy from English puts the first language's text in, to rewrite.
  • Translate (when AI translation is on) puts in a translation to check.

Or just type over the grey text.

Some collections, often News, keep each language of a post as a copy of its own. In those, the language menu lists the languages the post has. For one it lacks, press Add (a copy of the open language to type over) or Translate.

Translate with AI

When AI is connected to your site and Translation is on in Settings → AI, Clear can write a first version in another language:

  • Translate automatically, when you add a language or Fill in what is missing.
  • Translate beside an empty field in a record, or for a post's missing language.

Each translation is a draft. A page or record usually takes one AI answer, and the monthly limit in Settings → AI counts them. On Settings → Languages, Automatic translation (under On the site) says whether it is on, off or not available.

Remove a language

  1. Press ⋯ beside it, then Remove. (To remove the first language, make another the default first.)
  2. Its text stays saved, and comes back if you add the language again. Tick Also delete its text to delete it, as drafts: the live site keeps it until you publish, and each page's History keeps it after.
  3. Press Remove, keep its text (or Remove and delete its text).

A language removed with its text kept shows under Text kept from other languages, with Add back.

Who can do what

  • Adding, filling, ordering and removing languages: Admins and Owners.
  • Writing in every language, and Translate beside a field: anyone who may edit.
Last updated October 23, 2026