# Localization

## Elsa Studio Localization

Elsa Studio Localization allows localizing the Studio UI to different languages.

`ILocalizationProvider` is the interface that needs to be implemented to provide the localized strings for the Studio UI.

Create your own localization file (Using the resource file or any alternative method' and implement the `ILocalizationProvider` interface.

Afterwards, register your implementation in the DI container.

```csharp
builder.Services.AddSingleton<ILocalizationProvider, MyLocalizationProvider>();
```

## Steps to Enable Localization

### For Blazor Server

1. Add Reference to `Elsa.Studio.Localization.BlazorServer` package.
2. Add the following to your `Program.cs`

   ```csharp
   // Define the Localization Configuration
   var localizationConfig = new LocalizationConfig
   {
       ConfigureLocalizationOptions = options =>
       {
           configuration.GetSection(LocalizationOptions.LocalizationSection).Bind(options);
           options.SupportedCultures = new[] { options?.DefaultCulture ?? new LocalizationOptions().DefaultCulture }
               .Concat(options?.SupportedCultures.Where(culture => culture != options?.DefaultCulture) ?? []) .ToArray();
       }
   };

   // Register the Localization Module
   builder.Services.AddLocalizationModule(localizationConfig);

   // If using your own, register your locallization provider
   builder.Services.AddSingleton<ILocalizationProvider, MyLocalizationProvider>();

   // Add The localization Middleware. Making Sure that Controllers are also mapped.
   app.UseElsaLocalization();
   app.MapControllers();
   ```
3. Add below configuration in the `appsettings.json` file, specifying the supported cultures.

   ```json
   "Localization": {
     "DefaultCulture": "en-US",
     "SupportedCultures": [
       "en-GB",
       "nl-NL"
     ]
   }
   ```

### For Blazor WebAssembly

1. Add Reference to `Elsa.Studio.Localization.BlazorWasm` package.
2. Define the Localization Configuration

   ```csharp
   // Define the Localization Configuration
   var localizationConfig = new LocalizationConfig
   {
       ConfigureLocalizationOptions = options =>
       {
           configuration.GetSection(LocalizationOptions.LocalizationSection).Bind(options);
           options.SupportedCultures = new[] { options?.DefaultCulture ?? new LocalizationOptions().DefaultCulture }
               .Concat(options?.SupportedCultures.Where(culture => culture != options?.DefaultCulture) ?? []) .ToArray();
       }
   };

   // Register the Localization Module
   builder.Services.AddLocalizationModule(localizationConfig);

   // If using your own, register your locallization provider
   builder.Services.AddSingleton<ILocalizationProvider, MyLocalizationProvider>();

   // Use the localization Middleware
   await app.UseElsaLocalization();
   ```
3. Add below configuration in the `appsettings.json` file, specifying the supported cultures.

   ```json
   "Localization": {
     "DefaultCulture": "en-US",
     "SupportedCultures": [
       "en-GB",
       "nl-NL"
     ]
   }
   ```


---

# Agent Instructions: 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.elsaworkflows.io/studio/localization.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.