> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Game-supported and unsupported locales

> Plan supported and unsupported XBOX locales in your GDK package Resources, test with xbconfig preferredlanguages, and add an in-title language picker.

Include every locale you plan to support in your package's `Resources` section — even if XBOX doesn't yet support that locale for user selection. Unsupported locales aren't reachable through the console UI, but shipping them in the package means the title automatically supports them once they're added.

Optionally give users an in-title language picker so they can override the console's language.

## Testing unsupported locales

1. Force the locale from the command line:
   ```cmd theme={null}
   xbconfig preferredlanguages=ja-JP
   ```
   With the locale set and present in the manifest, you can exercise both manifest-localized and in-title resources.
2. Add a temporary in-title language picker. This only exercises in-title resources.

## Related API documentation

* [XGameRuntime features reference](/reference/system/xgameruntimefeature/xgameruntimefeature_members) — `XGameRuntimeLocale`
* [MicrosoftGame.config elements reference](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) — supported-locale manifest schema


## Related topics

- [Localization and globalization overview](/build/game-principles/localization.md)
- [Supported NLS functions](/build/game-principles/localization/supported-nls-apis.md)
- [Console-supported languages](/build/game-principles/localization/console-supported-languages.md)
- [Determining console locale and language](/build/game-principles/localization/determining-console-locale.md)
- [Creating discs](/build/core-features/common/packaging/creating-discs.md)