> For the complete documentation index, see [llms.txt](https://developers.discountninja.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.discountninja.io/discount-ninja-developer-hub/storefront-api/widgets/guiding-principles/localization.md).

# Localization

Web components are aware of the selected locale (e.g.: en-us, fr-fr, ...) and selected currency (e.g. USD, EUR...) that is selected in the storefront. 

The following aspects of localization are handled:

## Text direction

The CSS of the web components work for both left-to-right and right-to-left locales (e.g., European languages are left-to-right, Arabic right-to-left).

## Language

The app assumes that the selected locale is exposed using a global variable declared on the window object named `window.Shopify.locale`.

Text labels for supported languages can be overridden in the app. Support for other languages can also be added in the app.

{% hint style="info" %}
Multi-language capabilities are not available on all plans.
{% endhint %}

## Currency

Prices and amounts are formatted using the currency formatting that is configured in the app.

The app assumes that the selected currency is exposed using a global variable declared on the window object named `window.Shopify.currency`.