# Language & Locale

## Language

{% hint style="warning" %}
Note that for `iOS` we currently only set the language at the app level. Our Private Cloud offerings allow for setting system level language configurations. [Contact us](https://appetize.io/contact-us) to learn more.
{% endhint %}

### With Query Parameter

Set the language of the device by adding the `language` query parameter to your app or embed URL.

```uri
&language=af-ZA
```

See [Query Params Reference](/platform/query-params-reference.md#language) for more information.

### With JavaScript SDK

Set the language of the device via our JavaScript SDK

#### With Configuration

```typescript
await client.setConfig({
    language: 'af-ZA',
    ...
})
```

See [Configuration](/javascript-sdk/configuration.md#language) for more information.

#### With `SetLanguage`

```typescript
await session.setLanguage("af-ZA")
```

See [API Reference](/javascript-sdk/api-reference.md#setlanguage) for more information

## Locale

*iOS Only*

### **With Query Parameter**

Set the locale of the device by adding the `locale` query parameter to your app or embed URL.

```
&locale=fr_FR
```

See [Query Params Reference](/platform/query-params-reference.md#locale) for more information

### **With JavaScript SDK Configuration**

Set the locale of the device via our JavaScript SDK configuration

```typescript
await client.setConfig({
    locale: 'fr_FR',
    ...
})
```

See [Configuration](/javascript-sdk/configuration.md#locale) for more information

## Timezone

*Android Only*

### **With Query Parameter**

Set the time zone of the device by adding the `timezone` query parameter to your app or embed URL.

```
&timezone=Australia%2FAdelaide
```

See [Query Params Reference](/platform/query-params-reference.md#timezone) for more information

### **With JavaScript SDK Configuration**

Set the time zone of the device via our JavaScript SDK configuration

```typescript
await client.setConfig({
    timezone: 'Australia/Adelaide',
    ...
})
```

See [Configuration](/javascript-sdk/configuration.md#timezone) for more information

## iOSKeyboard

*iOS Only*

We also support an `iosKeyboard` [Query Parameter](#with-query-parameter-3) and [JavaScript SDK Configuration](#with-javascript-sdk-configuration-2) to specify the exact keyboard for iOS. The Android keyboard does not need this feature, as it updates automatically based on the language specified. A full list of supported keyboards can be found [here](https://pgssoft.github.io/AutoMate/Enums/SoftwareKeyboard.html).

### **With Query Parameter**

Set the keyboard of the device by adding the `iosKeyboard` query parameter to your app or embed URL.

```
&iosKeyboard=ja_JP@sw
```

See [Query Params Reference](/platform/query-params-reference.md#ioskeyboard) for more information

### **With JavaScript SDK Configuration**

Set the keyboard of the device by adding the `iosKeyboard` field via our JavaScript SDK configuration

```typescript
await client.setConfig({
    iosKeyboard: 'ja_JP@sw',
    ...
})
```

See [Configuration](/javascript-sdk/configuration.md#ioskeyboard) for more information.

## Sample Usage

#### Japanese language and keyboard

<https://appetize.io/demo?language=ja&iosKeyboard=ja_JP@sw>

#### French language with French AZERTY keyboard

<https://appetize.io/demo?language=fr&iosKeyboard=fr_FR@sw>


---

# 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.appetize.io/features/language-and-locale.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.