# 3.4.1. Install a new locale

Installing a locale enables the GeoPrism Registry to be translated to that language. This is the first step to enable a GeoPrism Registry instance to be translated. All locale options that can be installed in the GPR can be found [here](https://www.oracle.com/technetwork/java/javase/java8locales-2095355.html#util-text).

You must install all the locales you expect your users to need. Sometimes there are slightly different locales that all need to be included because a browser may have only one version and not the other. As an example, Khmer has two locale versions (*kh\_KM* and *kh*). Both of these locales must be installed and imported to ensure the Khmer language is shown in all browsers.

1. Navigate to the **Settings** page and scroll to the 'Localization' section.\\

   <figure><img src="https://lh5.googleusercontent.com/-m7NnBGImxdRljo0Z1mqp70oa2tABYEw9--Njc1SrKaljFFm1T1jUUdfTd720avSY0uzkVw9CWtXJxP69q9VrRjO6eu7HRfjFnRnNel9L1ecaCeH9RC9TVAgQU9Z5vLGw7CbcuWaXrs12tHJIMNkzWe1fh9UlsvV71RZ4r8qshmfzBE8UIib_0jH" alt=""><figcaption></figcaption></figure>
2. Click the **+** button to open the modal for installing a new locale.\\

   <figure><img src="https://lh6.googleusercontent.com/PnKbxK7Z4L8Xn1h93cYQ3Tlxi7X9zWF6qUkFErIRT12BtRzWrnAwwFGidBFKMRxuH4qKI1uc4T9XR_4K6lh4T0a1e7j1p7ndvYWSluCYB91IwhgnSmo-sXfOmephmRJ5fSuY70wFRS5lcfvmxB0ceGyxYx1plqsRBLklDVzFgokUTIYzKEI9fKfzow" alt=""><figcaption></figcaption></figure>
3. Select the language and country (the list of countries does not relate to the language that has been selected at this stage), and provide a display label for the new locale in the default locale and any existing locales.
4. Click **Submit**.
5. Installing a new locale adds a radio button option in the hamburger menu for that locale, to allow users to toggle between the default and installed locales.\
   ![](https://lh6.googleusercontent.com/MUEG3mr74QiGrgtcunvqH6hf__1f9aAAP6u1Y948s9xdeanVZ3UdUmyo_YUzwAU2P6GbUPaK5mGhfjYICStZopdzNJpx-j47cG0e_JyJMD7xwRDWK91W_CNbkDCdbfCIeEteh0rbh85vOXErRxKh75WOkyBYG5W8IQOrUdTEKqwj03SxHzPAqr8n3w)


---

# 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://docs.geoprismregistry.com/readme/current/deployment-and-setup/3.4-localisation/3.4.1-install-a-new-locale.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.