# Localization

## Why localization matters

Localization allows your FAQ content to be accessible to users in their native language, improving clarity, trust, and overall user experience. It ensures that your knowledge base can serve a diverse audience without duplicating structures for each language.

Supporting multiple languages also helps:

* Reduce support requests caused by language barriers
* Help international users have a better experience
* Keep all content in one place with versions for each language

## How to use localization in API

By default, each FAQ is created with a base localization when the community is set up.

### Retrieving content in different languages

There are two ways to get FAQ content in a specific language:

* Using the `SbLanguage` header with a value from the supported [`Language`](/docs/apis/faq/reference/enumerations/localization-language.md) enumeration
* Using the standard `Accept-Language` HTTP header with values based on **LCID** (Locale Identifier). These values follow the [RFC 5646](https://datatracker.ietf.org/doc/html/rfc5646) format, which is widely supported in browsers and HTTP clients. Only the first specified language will be used during request processing; others will be ignored.

If no language is provided, the system uses the default language of the FAQ.

If a language is specified:

* If localized content is available, it is returned.
* If not, the base language content is returned.

### Response

The response will include a `Content-Language` header that shows which language was used to return the resource. This value also follows the [RFC 5646](https://datatracker.ietf.org/doc/html/rfc5646) format. It also includes a `Content-SbLanguage` header with a value from the [`Language`](/docs/apis/faq/reference/enumerations/localization-language.md) enumeration.

#### Examples

**Request example using `SbLanguage` header**

```http
GET /faq/instances
Host: api.socialboards.com
Authorization: Bearer eyJhbGciOiJIUzUxMiIs
SbLanguage: norwegian
```

**Response**

```json
{
    "data": [
        {
            "availableLanguages": [
                "norwegian",
                "english",
                "swedish",
                "finnish"
            ],
            "bigLogoLink": "",
            "creationTime": "2023-08-18T08:42:42.2522564+00:00",
            "currentLanguage": "english",
            "customCss": "",
            "customerWebsiteLink": "https://mywebsite.com",
            "defaultFormLink": "",
            "displayName": "publicapitests",
            "facebookLink": "",
            "faviconLink": null,
            "footerContent": "<br>",
            "formLink": "",
            "googleAnalyticsCode": null,
            "googleTagManagerCode": null,
            "headerSubTitle": "Subtitle",
            "headerTitle": "Title",
            "instagramLink": "",
            "isAccessByPasswordEnabled": false,
            "isChatEnabled": false,
            "isCookieMessageHidden": true,
            "isDefault": true,
            "isFooterHidden": true,
            "logoLink": "",
            "name": "publicapitests",
            "stickyButtonColor1": "#f5f5f5",
            "stickyButtonColor2": "#f5f5f5",
            "stickyButtonColor3": "#f5f5f5",
            "stickyButtonTextColor1": "#231f1f",
            "stickyButtonTextColor2": "#231f1f",
            "stickyButtonTextColor3": "#231f1f",
            "templateType": "text_default",
            "twitterLink": ""
        }
    ],
    "errorCode": -1,
    "errorText": null
}
```

**Response headers**

```
Headers
Content-Language: no
Content-SbLanguage: norwegian
```

**Example using `Accept-Language` header**

```http
GET /faq/instances
Host: api.socialboards.com
Authorization: Bearer eyJhbGciOiJIUzUxMiIs
Accept-Language: no
```

**Response**

```json
{
    "data": [
        {
            "availableLanguages": [
                "norwegian",
                "english",
                "swedish",
                "finnish"
            ],
            "bigLogoLink": "",
            "creationTime": "2023-08-18T08:42:42.2522564+00:00",
            "currentLanguage": "english",
            "customCss": "",
            "customerWebsiteLink": "https://mywebsite.com",
            "defaultFormLink": "",
            "displayName": "publicapitests",
            "facebookLink": "",
            "faviconLink": null,
            "footerContent": "<br>",
            "formLink": "",
            "googleAnalyticsCode": null,
            "googleTagManagerCode": null,
            "headerSubTitle": "Subtitle",
            "headerTitle": "Title",
            "instagramLink": "",
            "isAccessByPasswordEnabled": false,
            "isChatEnabled": false,
            "isCookieMessageHidden": true,
            "isDefault": true,
            "isFooterHidden": true,
            "logoLink": "",
            "name": "publicapitests",
            "stickyButtonColor1": "#f5f5f5",
            "stickyButtonColor2": "#f5f5f5",
            "stickyButtonColor3": "#f5f5f5",
            "stickyButtonTextColor1": "#231f1f",
            "stickyButtonTextColor2": "#231f1f",
            "stickyButtonTextColor3": "#231f1f",
            "templateType": "text_default",
            "twitterLink": ""
        }
    ],
    "errorCode": -1,
    "errorText": null
}
```

**Response headers**

```
Headers
Content-Language: no
Content-SbLanguage: norwegian
```


---

# 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://developers.socialboards.com/docs/apis/faq/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.