> For the complete documentation index, see [llms.txt](https://docs.geoprismregistry.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geoprismregistry.com/readme/current-1/deployment-and-setup/3.4-localisation/3.4.1-install-a-new-locale.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-1/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.