# General Translation Changelog: gt-next 6.4.0: Locale aliasing
URL: https://generaltranslation.com/en-GB/blog/gt-next_v6_4_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2025-09-10

## Overview

In **gt-next 6.4.0**, we've introduced locale aliasing. This feature allows users to override any canonical locale with an alias.

***

## Setup

To support this, we've repurposed the `code` field in the `customMapping` parameter in the configuration. The `alias locale` is the locale used in your codebase. The `canonical locale` is the locale used in the API.

For example, General Translation uses `zh` instead of `cn`. If you want to use `cn` in your codebase for Chinese, then `cn` would be your alias locale and `zh` would be your canonical locale.

```json
"customMapping": {
  "cn": {
    "code": "zh"
  }
}
```

Additionally, we have decided to move custom mapping from `next.config.js` to `gt.config.json`. This also allows other libraries (`gtx-cli` and `gt-react`) to use this feature.


## Customisation

Because we are reusing the `customMapping` feature, you can further customise your alias locale. For example, say you want your `cn` alias to be labelled "Mandarin" instead of "Chinese":

```json
"customMapping": {
  "cn": {
    "code": "zh",
    "languageName": "Mandarin"
  }
}
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.