# WPML

**WP admin:** installed in `WP Admin → POS → Settings → Extensions`, and set per store in `WP Admin → POS → Stores`.

WPML saves every translation of a product as a product of its own. Without help, the POS shows them all: search for a watch and you get the English, French and German copies side by side. The free **WCPOS WPML** extension makes the POS show one language only, so each product appears once.

Cashiers have nothing to set up: the first section shows what changes for them. The rest of the page is for the store's administrator.

## What the cashier sees[​](#what-the-cashier-sees "Directe link naar What the cashier sees")

Product search, the product grid and a variable product's options all show one language, the store's, with one product per item on the shelf. Nothing changes in how a cashier sells: add to cart, take the payment, print the receipt as usual. See [Checkout](/nl/getting-started/make-sale.md).

## Install the extension[​](#install "Directe link naar Install the extension")

Before you start

You need [WPML](https://wpml.org/) set up on the site with a default language, and an administrator login to **WP Admin**.

An administrator installs it once, in **WP Admin**. Products use WPML's **default language** unless you choose a different language for the store. After activating the extension, follow [Check it works](#check) below.

### With WCPOS Pro[​](#install-pro "Directe link naar With WCPOS Pro")

1. Go to **POS → Settings → Extensions**.
2. Find **WCPOS WPML** and press **Install**. It installs and switches on in one step, and the card shows **Active**. If it shows **Inactive** instead, press **Activate**.

See [Installing an extension](/nl/manage-store/add-ons.md#installing-an-extension) for updates and auto-updates.

### With the free plugin[​](#install-free "Directe link naar With the free plugin")

The Extensions screen lists the extension, but its buttons need Pro. Instead:

1. Download `wcpos-wpml.zip` from the extension's [latest release](https://github.com/wcpos/wcpos-wpml/releases/latest).
2. Go to **Plugins → Add Plugin** and press **Upload Plugin**.
3. Choose the file you downloaded and press **Install Now**.
4. Press **Activate Plugin**.

### Check it works[​](#check "Directe link naar Check it works")

1. Open the POS. At the bottom of the products panel, next to **Showing … of …**, press and hold the [sync button](/nl/sell/find-products/product-display.md#footer) () and choose **Clear and Refresh**.
2. Search for a product that has translations. It shows once, in WPML's default language, or in the store's language if you chose one below.

If it still shows two or three times, see [If something goes wrong](#goes-wrong).

## Choose a store's language[​](#store-language "Directe link naar Choose a store's language")

With WCPOS Pro, each [store](/nl/manage-store/stores.md) can show its own language: a French shop and an English shop on the same site each see their own translations.

The Language page needs three things

WCPOS Pro, the **WCPOS WPML** extension active, and WPML switched on with at least one language. Without them, the store's menu has no **Language** page. If **WooCommerce Multilingual** is installed, it must be version 4.11.0 or later.

1. In **WP Admin**, go to **POS → Stores** and click the store's name.
2. In the store's menu, under **Extensions**, open **Language**.
3. Under **Store language**, pick a language. The list shows every language WPML has switched on. **Default language** follows WPML's default. The choice saves by itself.
4. Open the POS for this store and [check it works](#check). The product shows once, in the language you picked.

Other stores keep their own language.

### Product language and screen language[​](#product-and-screen-language "Directe link naar Product language and screen language")

A store has two settings called **Language**, in two places in the store's menu:

* **Extensions → Language → Store language** chooses which translation of each product the POS shows.
* **Currency & language → Language** chooses the words on the POS screen and on receipts. See [Fill in the store's pages](/nl/manage-store/stores/set-up-stores.md#store-pages).

tip

For a French shop, set both to French.

## If something goes wrong[​](#goes-wrong "Directe link naar If something goes wrong")

**Each product still shows two or three times.** Check that **WCPOS WPML** is active in **Plugins**, and that WPML has a default language. If **WooCommerce Multilingual** is installed, it must be version 4.11.0 or later: with an older version the extension switches itself off.

**There is no Language page under Extensions in the store's menu.** The page needs WCPOS Pro, the extension active, and WPML switched on with at least one language. If **WooCommerce Multilingual** is installed, it must be version 4.11.0 or later.

**A POS Only or Online Only product shows up where it shouldn't in another language.** POS Only and Online Only are saved against each product, and each translation is its own product, so a translation does not take the setting from the original. Open each translation and set the same visibility on it. See [POS Only Products](/nl/manage-store/products/pos-only-products.md).

With WCPOS Pro

Every store chooses its own product language. Without Pro there is one store, and it uses WPML's default language.

For developers: filters and stored data

The extension works only on the product and variation requests the POS makes: it adds WPML's `lang` to their product query. Other WooCommerce REST clients are not affected. The language comes from the store the request names, when the signed-in user may use that store, and otherwise from WPML's default.

* A store's choice is saved in the store's `_wcpos_wpml_language` meta. An empty value means WPML's default language.
* `wcpos_wpml_resolved_language` changes the language used for one request.
* `wcpos_wpml_default_language` changes the default language.
* `wcpos_wpml_is_supported` switches the extension on or off.
* `wcpos_wpml_minimum_wpml_version` and `wcpos_wpml_minimum_wcml_version` set the lowest WPML and WooCommerce Multilingual versions it runs with. The WooCommerce Multilingual minimum is `4.11.0`; WPML has none by default.

Source: [github.com/wcpos/wcpos-wpml](https://github.com/wcpos/wcpos-wpml).

## Related Documentation[​](#related-documentation "Directe link naar Related Documentation")

* [Extensions](/nl/manage-store/add-ons.md)
* [WCPOS Polylang](/nl/settings/languages/polylang.md) and [WCPOS WP Multilang](/nl/settings/languages/wp-multilang.md), for the other translation plugins
* [Setting up stores](/nl/manage-store/stores/set-up-stores.md)

[Setting up storesEach store's address, currency, language and staff](/nl/manage-store/stores/set-up-stores.md)

[POS Only ProductsKeep products out of the online store or out of the POS](/nl/manage-store/products/pos-only-products.md)