> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Configure Customer Widget Language on My Platform?

> Learn about languages supported by Gameball customer widget and how to enable them.

Gameball allows you to display the customer widget in different languages based on the active language of your platform.

Currently, Gameball supports the following languages:

<CardGroup cols={3}>
  <Card title="Arabic" icon="globe">
    ar
  </Card>

  <Card title="Danish" icon="globe">
    da-DK
  </Card>

  <Card title="Dutch" icon="globe">
    nl
  </Card>

  <Card title="English" icon="globe">
    en
  </Card>

  <Card title="French" icon="globe">
    fr
  </Card>

  <Card title="German" icon="globe">
    de
  </Card>

  <Card title="Hungarian" icon="globe">
    hu
  </Card>

  <Card title="Italian" icon="globe">
    it
  </Card>

  <Card title="Polish" icon="globe">
    pl
  </Card>

  <Card title="Portuguese" icon="globe">
    pt
  </Card>

  <Card title="Spanish" icon="globe">
    es
  </Card>

  <Card title="Swedish" icon="globe">
    sv
  </Card>

  <Card title="Taiwanese Mandarin" icon="globe">
    zh-TW
  </Card>
</CardGroup>

***

## What If Your Language Is Not Listed?

Only the languages above are officially supported. If your preferred language is not available, you can repurpose an existing language slot as a workaround: select any language from the supported list, then manually replace every text field throughout the system with translations in your desired language.

<Note>
  This workaround requires you to update every translatable text field individually. See [What Fields Will Be Affected](#what-fields-will-be-affected-once-you-add-a-new-language) for the full list.
</Note>

***

## How to Choose the Default Language

<Steps>
  <Step title="Log in to the Gameball Dashboard">
    Log in to the **Gameball dashboard**.
  </Step>

  <Step title="Navigate to Widget General Settings">
    From the side menu, go to **Widget**, then select the **General** tab.
  </Step>

  <Step title="Set Your Default Language">
    Navigate to the **Languages** section and choose your **Default Language** from the available options.

    <Frame>
      <img src="https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/default-language-selection.png?fit=max&auto=format&n=qQadqvPdUG22Jh8m&q=85&s=e2f0c5461ea641132e5668751cff7930" alt="Default language selection in widget settings" width="2716" height="1440" data-path="images/product-docs/customer-widget/default-language-selection.png" />
    </Frame>
  </Step>
</Steps>

Your account must have a default language. The data under this default language will be displayed to your **customers** whenever any additional active language has missing data.

However, you can still add and activate **more than one language** on your account.

***

## How to Add an Extra Language

<Steps>
  <Step title="Open the Add Language Dialog">
    Click on **Add Language** next to "Additional Languages."
  </Step>

  <Step title="Choose and Add the Language">
    Choose the second language and click **Add**.

    <Frame>
      <img src="https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/add-additional-language.png?fit=max&auto=format&n=qQadqvPdUG22Jh8m&q=85&s=efe1c6baf86741cb6a61ce3024c55123" alt="Adding additional language to widget" width="1290" height="558" data-path="images/product-docs/customer-widget/add-additional-language.png" />
    </Frame>
  </Step>

  <Step title="Save Changes">
    Make sure to click **Save** to apply your changes.
  </Step>
</Steps>

***

## What Happens After Adding an Additional Language?

Once you add a new supported language to your Gameball account in addition to the default one, all fields across the system that are shown to your customers through the widget will display an additional input field for the newly added language.

See the example below for how the level name field appears when two languages are active (left) versus when only one language is active (right):

<Frame>
  <img src="https://mintcdn.com/gameball/qQadqvPdUG22Jh8m/images/product-docs/customer-widget/language-fields-comparison.png?fit=max&auto=format&n=qQadqvPdUG22Jh8m&q=85&s=bac7d96202656d00576a50ee745d4a6c" alt="Language fields comparison with multiple languages" width="1787" height="738" data-path="images/product-docs/customer-widget/language-fields-comparison.png" />
</Frame>

***

## What Fields Will Be Affected Once You Add a New Language?

Once you add a new supported language to your Gameball account in addition to the default one, the following fields will require corresponding data in the newly added language:

* **Score name**, if you are using Score as the leveling-up method
* **Points name**
* **Level name**
* **Challenge name and description**
* **Guest view intro and button text**
* **Referral tab title and description**
* **Message title, body, and button text**
* **All system notifications**

<Warning>
  In case you are adding a new language after finishing the experience design and configurations, you will need to update all the above fields one by one to add the corresponding data for every field.
</Warning>

***

## What's Next?

<CardGroup cols={2}>
  <Card title="Customize Widget to Match Your Brand" icon="palette" href="/product-documentation/customer-widget/start-configuring-profile/customize-your-gameball-customer-widget-to-match-your-brand">
    Adjust colors, fonts, icons, and identity to align the widget with your platform's look and feel.
  </Card>

  <Card title="Customize Tabs Visibility and Order" icon="eye" href="/product-documentation/customer-widget/start-configuring-profile/customizing-tabs-visibility-and-order-in-gameball-widget-settings">
    Control which tabs appear in your widget and in what order they are displayed.
  </Card>

  <Card title="Guest Profile Configuration for Web" icon="user" href="/product-documentation/customer-widget/start-configuring-profile/guest-widget-configuration-for-web">
    Configure the guest experience, including images, sign-up URLs, and login redirects.
  </Card>

  <Card title="Customize the Widget Launcher" icon="rocket" href="/product-documentation/customer-widget/start-configuring-profile/customize-your-loyalty-launcher-to-fit-your-platforms-interface">
    Control the shape, position, icon, and visibility of your loyalty launcher button.
  </Card>
</CardGroup>
