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

# Localization

The SDK displays some text directly to the user (error messages, restore or login button text, …). These texts are translated in 18 languages:

* English
* French
* German
* Spanish
* Portuguese
* Italian
* Czech
* Polish
* Greek
* Chinese (Simplifed and traditional)
* Japanese
* Russian
* Turkish
* Swedish
* Korean
* Indonesian
* Arab

That means that every error message and UI element will automatically translated in the user device language (if matching).

### Manually set the language

By default, Purchasely uses the device / app language set by the OS.\
If your app has an internal language selector, you will want to set that language to your Paywalls. You can force the SDK to be working in a specific language by calling the following method.

Your language code must be [ISO 639-1](https://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-1) or [ISO 639-2](https://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-2).

{% tabs %}
{% tab title="Swift" %}

```swift
// Force language in french
let locale = Locale(identifier: "fr")
Purchasely.setLanguage(from: locale)
```

{% endtab %}

{% tab title="Objective-C" %}

```objectivec
// Force language in french
NSLocale *locale = [NSLocale localeWithLocaleIdentifier: @"es"];
[Purchasely setLanguageFrom: locale];
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
// Force language to spanish
Purchasely.language = Locale("es")

// Force language to italian
Purchasely.language = Locale.ITALY
```

{% endtab %}

{% tab title="Java" %}

```java
// Force language to spanish
Purchasely.setLanguage(new Locale("es"));

// Force language to italian
Purchasely.setLanguage(Locale.ITALY);
```

{% endtab %}

{% tab title="React Native" %}

```typescript
// Force language to spanish
Purchasely.setLanguage("es");
```

{% endtab %}

{% tab title="Cordova" %}

```javascript
// Force language to spanish
Purchasely.setLanguage("es");
```

{% endtab %}

{% tab title="Flutter" %}

```dart
Purchasely.setLanguage('es');
```

{% endtab %}

{% tab title="Unity" %}

```csharp
private PurchaselyRuntime.Purchasely _purchasely;

_purchasely.SetLanguage("en");
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
If your paywall is not available in the language you have set, Purchasely will display text inside the paywall in the language of the paywall set in Purchasely console and not the language you have enforced for consistency.
{% endhint %}

### Override default localizations

If you want to change the tone of the messages, you can override our translations and set yours. To do so, you just need to set the key and value corresponding to the message you want to change in your own `Localizable.strings` file (iOS) or `strings.xml` (Android) file.

The keys that can be overriden are in the following files with the default translations in English.

{% file src="/files/6GaBsybZNv10InnPpp55" %}
iOS Localizable.strings - English version
{% endfile %}

{% file src="/files/hhzh9nZetKTfEbQkLMa0" %}
Android strings - English version
{% endfile %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://purchasely.gitbook.io/purchasely/advanced-features/localization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.