# Languages

https://docs.wisecp.com/de/languages

Enable or disable installed languages to offer clients only ready language choices and restore them later without deleting translations.

## Reaching the Screen

Panel menu: **Languages** then **Browse Languages**: `{admin}/languages`

Staff who can only view languages see no submenu: for them **Languages** opens this list directly.

## What Is on the Screen

A short page: two notices, one button and the list of installed languages.

- **Notices**: Two bands above the list. The first says what this screen is for, the second warns that bulk text editing is meant for wording only: keys, variables and HTML tags have to stay as they are.
- **Find and Replace**: Opens the search screen that works across every language pack at once. Shown only to staff who can edit languages. An installed module can add its own buttons to the same strip.
- **The list**: One row per installed language, whether it is on or off. There is no paging trouble here: an installation carries a fixed set of languages.
- **Search and download**: The usual list controls sit above the table: a search box, the rows-per-page selector and a download icon that saves the list as a file.

### A row

The language name is a link to its edit screen, and the folder code sits right next to it in small type. That code is the language's real identity: it is what appears in addresses as `/de/` (the default language is the exception, its addresses carry no prefix) and what every text file of that language lives under.

The default language is at the top of the list. A language that is switched off drops to the bottom and is shown faded, so the set your customers actually see can be read at a glance.

## Fields

- **Language Name**: The name visitors see in the language picker, followed by the folder code. Both come from the language package itself. The edit screen shows the display name read-only, and the folder code is the language's directory name, which cannot be changed from the panel at all.
- **Translated**: How much of the language is actually translated, as a percentage of English. Hover the badge for the counts behind it. The figure is read from a cache, so a change you have just made may take a while to show up here.
- **Default**: A tick marks the language your site falls back to. Exactly one language carries it; the others show a dash instead. Which one it is set on the language's own edit screen.
- **Status**: The switch that offers the language to your customers or takes it away. It saves the moment you click it, with no separate save button. The switch is closed on the default language and for staff without editing rights.
- **Edit**: The row menu at the end of the line. It holds a single action, and it is only there for staff who can edit languages. There is no delete action here.

## Tasks

### Stop offering a language

1. Find its row in the list.
2. Click the switch in the **Status** column.
3. The row fades at once and a saved confirmation appears; the language disappears from your site's language picker. It moves to the bottom of the list the next time the page is loaded. The same switch brings it back.

### See how complete a language is

1. Read the badge in the **Translated** column: green is nearly complete, yellow is partial, red means most of it is still English.
2. Hover the badge to see how many texts of the total have actually been translated.
3. English carries a **Reference** badge instead of a percentage: it is the yardstick every other language is measured against.

### Open a language

1. Click the language name, or use **Edit** in the row menu.
2. The edit screen opens: display name, sort order, the default flag, and the JSON export and import used for bulk text changes.

## Things to Watch

> **Languages are not created or deleted here**
> 
> They ship with the product, so the panel edits the ones already installed and nothing else. If a language should not reach your customers, switch it off: that is reversible, whereas removing a language tree would leave an installation you could not repair from here.

> **Switching off hides, it does not erase**
> 
> Everything already written in that language stays where it is. The language simply stops being offered, and switching it back on returns it exactly as it was.

> **The default language cannot be switched off**
> 
> Its switch is closed, because the site has to be able to fall back somewhere. To hand the role to another language, open that language and set it as the default there; the previous one becomes an ordinary language again and can then be switched off.

## Required Privileges

The screen opens for staff holding `LANGUAGES_LOOK` or `LANGUAGES_OPERATION`. Everything that changes something needs `LANGUAGES_OPERATION`: without it the status switches are closed, and neither the **Find and Replace** button nor the row menu is shown. Downloading the list follows `TABLE_EXPORT`.

## Related Articles

- [Editing a Language](https://docs.wisecp.com/en/editing-a-language)
- [Find and Replace in Translations](https://docs.wisecp.com/en/find-and-replace-in-translations)
