# DiscoverLocalesAsync(LocalizationSettings, CancellationToken)

> Registers any additional locales this provider can serve.

## Definition

* **Type:** Method
* **Namespace:** [Unity.Localization](/engine/7000.0/script-reference/unity/localization.md)
* **Assembly:** UnityEngine.LocalizationRuntimeModule

```csharp
Awaitable DiscoverLocalesAsync(LocalizationSettings settings, CancellationToken cancellationToken = default)
```

### Parameters

**** (\[LocalizationSettings]\(/engine/7000.0/script-reference/unity/localization/localizationsettings)): The settings to register discovered locales on.**** (\[CancellationToken]\(https\://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)): The token that signals the discovery should be canceled.

### Returns

| Type                                                                  | Description                                                                                                             |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| [Awaitable](/engine/7000.0/script-reference/unityengine/awaitable.md) | An [Awaitable](/engine/7000.0/script-reference/unityengine/awaitable.md) that completes once locale discovery finishes. |

### Remarks

Called during [LocalizationSettings.InitializeAsync](/engine/7000.0/script-reference/unity/localization/localizationsettings/initializeasync.md). Add each discovered locale with [LocalizationSettings.AddLocale](/engine/7000.0/script-reference/unity/localization/localizationsettings/addlocale.md), and honor `cancellationToken` for long-running discovery. Initialization waits for this method, so nothing inside it can wait for initialization. Awaiting [LocalizationSettings.InitializeAsync](/engine/7000.0/script-reference/unity/localization/localizationsettings/initializeasync.md), or a value in the selected locale, waits for this method to return, so it never finishes. To read a value here, pass the locale to read it in.