VTEX Developer Portal

The Locale Switcher app provides a component capable of changing the current language of your store.

img-locale-switcherimg-locale-switcher

Configuration

  1. Add the Locale Switcher app to your theme's dependencies in the manifest.json file:
 "dependencies": {
+  "vtex.locale-switcher": "0.x"
 }
  1. Add the locale-switcher block to your header. For example:
"header-row#desktop": {
  "children": [
    // (...)
    "locale-switcher",
    "login",
    "minicart.v2"
  ]
},
  1. Open a ticket to our support team in order to adjust your store's binding with the desired languages.

*Caution: The third step is mandatory. If no ticket is opened requiring the desired languages, the selection list may not appear on the Locale Switcher component.*

Customization

In order to apply CSS customizations in this and other blocks, follow the instructions given in the recipe on Using CSS Handles for store customization.

CSS Handles
button
buttonText
container
list
listElement
localeIdText
relativeContainer

Contributors ✨

Thanks goes to these wonderful people:

This project follows the all-contributors specification. Contributions of any kind welcome!

Updated 4 months ago


Locale Switcher


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.