# Form localization

## Availability

This is an [Orbeon Forms PE](https://www.orbeon.com/download) feature.

## Localizing your forms

Form Builder has localization support. This means that your form's titles, labels, help messages, etc. can be specified in multiple languages. At runtime, the form user is presented with a default language and can switch the most appropriate language.

By default, only one language is present, typically English. The default language is configurable by the Form Builder system administrator. By pressing the "⊕" icon, a dropdown dialog shows. The dropdown list allows you to pick a new language to add to the list of languages of the form.

![Adding a language](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-0ecf0980dd2f9e9b846487470f9e9da592197cf0%2Flanguage-add.png?alt=media)

When a new language is added:

* It appears in the list of languages at the top right corner of the WYSIWYG area
* All the resources of the previously selected language are copied into the new language

You switch between languages by clicking on the language selector. All localizable resources edits impact the currently selected language.

![Selecting a language](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-8a1076e60ae54d82fcf8bfd869ea600d6af4c8fb%2Flanguage-select.png?alt=media)

You can remove the currently selected language by pressing the "⊖" icon. This will remove all the resources associated with that language, so you must be careful before proceeding. A warning dialog will appear before the deletion is completed.

Here is how you typically proceed to create a form in two languages:

* Create the form in the primary language and add all localizable resources such as labels, help messages, hints, etc.
* Add the secondary language.
* Translate all localizable resources now visible on the form.
* When testing the form, you can switch between the two languages to make sure no resource was missed.

## See also

* [Localization](https://doc.orbeon.com/form-runner/features/localization)
* [Localizing Orbeon Forms](https://doc.orbeon.com/contributors/localizing-orbeon-forms)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.orbeon.com/form-builder/localization.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.