> For the complete documentation index, see [llms.txt](https://wasd-dev.gitbook.io/wasd/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wasd-dev.gitbook.io/wasd/other-things/quickstart.md).

# Editing localization files

How do locale files work?

***

### Editing Localization Files

> ox\_lib provides a built-in localization system using JSON files stored in the `locales` folder. The `lib.locale()` function is responsible for loading the appropriate localization file based on the server’s configuration.

#### Default Localization File

> By default, `locales/ox:locale|en>.json` as the primary localization file. However, this can be changed based on the server configuration.

#### Setting the Localization Language

> The server owner can specify a different localization file by setting the `ox:locale` value in `server.cfg`. The value assigned to `ox:locale` determines which file should be loaded.

For example:

```ini
set ox:locale "pt"
```

This configuration instructs ox\_lib to load `locales/pt.json` instead of the default `locales/en.json`.

#### Adding a New Localization File

> To support a new language, the server owner must:
>
> 1. Create a new JSON file in the script `locales` folder, following the `locales/en.json` format.
> 2. Ensure the correct `ox:locale` value is set in `server.cfg`.
> 3. Populate the new JSON file with localized strings matching the existing structure.

Example: If the server's `ox:locale` is set to `fr`, then a corresponding `locales/fr.json` file should be created.