> For the complete documentation index, see [llms.txt](https://docs.beefree.io/beefree-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.beefree.io/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/other-customizations/advanced-options/custom-languages.md).

# Custom Languages

{% hint style="info" %}
You can choose one of [20+ languages](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/getting-started/readme/installation/configuration-parameters.md) for the visual builder's UI when initializing the builder. If you want to use custom language strings, however, you will need to use a Custom Language. This feature is available on Beefree SDK [Core plan](https://dam.beefree.io/pluginpricing) and above. If you're on the Essentials plan, upgrade a [development application](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/getting-started/readme/development-applications.md#development-applications) for free to try this and other Core-level features.
{% endhint %}

## Using a Translation URL

You may now override the default Beefree SDK language file by providing a URL to your own translations.  This is an advanced feature and will replace all languages used by the editor with the languages defined in the custom file.

```javascript

var beeConfig = {
      uid: config.uid,
      ...
      translationsUrl: 'https://www.yourdomain.com/xx-XX.json',
      ...
}

```

## Using a JSON Object

The easiest method to override specific text labels is to [pass a JSON object in your `beeConfig`](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/getting-started/readme/installation/configuration-parameters.md#passing-configurations-to-beefree-sdk), which contains the segments of the language file you want to override.

```javascript
var beeConfig = {
    uid: config.uid,
    // additional configuration properties...
    language: 'en-US',
    translations: {
        'bee-common-widget-bar': {
            content: 'MODULES',
        },
        // additional translations...
    },
    // other properties...
};
```

### **Example: overriding the Help icon label in the default toolbar**

```javascript

var beeConfig = {
      uid: config.uid,
      ...
      translations: {
         "bee-common-top-bar": {
           help: "Support"
         },
      }
      ...
}

```

### **Example: overriding the Rows tab label in the sidebar**

```javascript


var beeConfig = {
      uid: config.uid,
      ...
      translations: {
          "bee-common-widget-bar": {
            "structure": "Catalog"
          }
        },
      }
      ...
}


```

### **Example: overriding the Preheader**

```json
{
    "translations": {
        "bee-head-meta-preheader": {
            "name": "New Preheader",
            "placeholder": "New Enter Preheader"
        }
    }
}

```

### Example: Defining or adding a translation for "email" <a href="#sample-language-file" id="sample-language-file"></a>

The following code defines a translation object where the title for "bee-settings-details" is set to "New Email Details" specifically for the "email" field.

```json
translations: {
    "bee-settings-details": {
        "title": {
            "email": "New Email Details"
        }
    }
}
```

## Sample language file <a href="#sample-language-file" id="sample-language-file"></a>

*Check out our Github repository for* [*starter language templates*](https://dam.beefree.io/beecustomlanguages) *in all supported languages.*


---

# 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://docs.beefree.io/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/other-customizations/advanced-options/custom-languages.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.