- Translate all WooCommerce products (simple, variable, grouped, external)
- Easy translation management for products, categories and attributes
- Keeps the same language through the checkout process
- Sends emails to clients and admins in their language
- Allows inventory tracking without breaking products into languages
- Enables running a single WooCommerce store with multiple currencies based either on a customer’s language or location
- Allows enabling different payment gateways based on a customer’s location
Compatibility with WooCommerce Extensions
Almost every WooCommerce store uses some extensions. WooCommerce Multilingual is fully compatible with popular extensions, including:
- WooCommerce Bookings
- WooCommerce Table Rate Shipping
- WooCommerce Subscriptions
- WooCommerce Product Add-ons
- WooCommerce Tab Manager
Looking for other extensions that are tested and compatible with WPML? See the complete list of WooCommerce extensions that are compatible with WPML.
For step by step instructions on setting up a multilingual shop, please go to WooCommerce Multilingual Manual page.
After installing, follow the steps of the setup wizard to translate the store pages, configure what attributes should be translated, enable the multi-currency mode and other settings.
Then, continue to the ‘Products’ and any categories, tags and attributes that you use.
When you need help, go to WooCommerce Multilingual support forum.
This version of WooCommerce Multilingual works with WooCommerce > 3.9.0
Minimum versions for WPML and modules
WooCommerce Multilingual checks that the required components are active and up to date.
If the checks fail, WooCommerce Multilingual will not be able to run.
- WordPress 4.7 or later
- PHP version 5.6 or later
MySQL version 5.6 or later
WooCommerce 3.9.0 or later
- WPML Multilingual CMS 4.4.11 or later
- WPML String Translation 3.1.9 or later
- WPML Translation Management 2.10.7 or later
WordPress automatic installation
In your WordPress dashboard, go to the Plugins section and click ‘Add new’.
If you’re already using WPML on your site, in your WordPress dashboard, go to the Plugins section, click ‘Add new’ and go to the ‘Commercial’ tab.
- Upload ‘woocommerce-multilingual’ to the ‘/wp-content/plugins/’ directory
- Activate the plugin through the ‘Plugins’ menu in WordPress
After installing the plugin either automatically or manually:
- Follow the steps of the setup wizard for the basic required configuration
- Translate existing content: products, attributes, permalink bases
- Optionally, add secondary currencies
Once you installer WooCommerce Multilingual, the built in Installer works together with the WordPress automatic update built in logic to make the updating process as easy as it can be.
Does this work with other e-commerce plugins?
No. This plugin is tailored for WooCommerce.
What do I need to do in my theme?
Make sure that your theme is not hard-coding any URL. Always use API calls to receive URLs to pages and you’ll be fine.
My checkout page displays in the same language
In order for the checkout and store pages to appear translated, you need to create several WordPress pages and insert the WooCommerce shortcodes into them. You’ll have to go over the documentation and see that you performed all steps on the way.
Can I have different URLs for the store in different languages?
Yes. You can translate the product permalink base, product category base, product tag base and the product attribute base on the Store URLs section.
Why do my product category pages return a 404 error?
In this case, you may need to translate the product category base. You can do that on the Store URLs section.
Can I set the prices in the secondary currencies?
By default, the prices in the secondary currencies are determined using the exchange rates that you fill in when you add or edit a currency. On individual products, however, you can override this and set prices manually for the secondary currencies.
Can I have separate currencies for each language?
Yes. By default, each currency will be available for all languages, but you can customize this and disable certain currencies on certain languages. You also have the option to display different currencies based on your customers’ locations instead.
Is this plugin compatible with other WooCommerce extensions?
WooCommerce Multilingual is compatible with all major WooCommerce extensions. We’re continuously working on checking and maintaining compatibility and collaborate closely with the authors of these extensions.
Contributors & Developers
“WooCommerce Multilingual — run WooCommerce with WPML” is open source software. The following people have contributed to this plugin.Contributors
“WooCommerce Multilingual — run WooCommerce with WPML” has been translated into 10 locales. Thank you to the translators for their contributions.
Interested in development?
- Fixed a currency geolocation bug due to WC 6.1.
- Replace is_ajax (deprecated) with wp_doing_ajax.
- Fixed analytics in secondary languages.
- Fixed an issue with overwriting order subtotal with total value.
- Fixed a regression affecting correct translation of emails.
- Fixed several glitches in WooCommerce Analytics reports.
- Updated the Italian translations.
- Removed translation files for some locales that we cannot maintain anymore and updated the remaining locale translations.
- Revamped the wizardâ€™s â€œTranslation Optionsâ€ step to include â€œTranslate Everythingâ€ mode.
- Updated logic to add noindex to reviews in all languages.
- Fixed to show the correct WooCommerce Bookings items in the order summary.
- Fixed an issue with selecting a country in multi-currency modal.
- Reverted the fix to round prices if taxes are enabled.
- Added two more exchange rate services: http://exchangeratesapi.io and http://openexchangerates.org.
- Added an option to update currency exchange rates every hour.
- Added a new option to display product reviews in all languages by default.
- Product reviews can now be translated.
- Product reviews are now wrapped in a div with lang parameter for better SEO.
- Removed loading of jQuery cookie library.
- Began storing the client country when geolocation is in use to allow cache plugins to deliver pages based on location.
- Raised the WPML requirements to 4.4.11.
- Fixed an issue with applying rounding to shipping rates on checkout.
- Fixed an issue with synchronizing translations of WooCommerce Bookings.
- Fixed a possible PHP warning for state inconsistencies in Product Bundles integration.
- Fixed an issue with advanced category rules in Dynamic Pricing.
- Fixed an issue with translated duplicates in the list of store URLs.
- Fixed an issue with translating category IDs in REST response.
- Added language support for the search block widget.
- Fixed a fatal error when updating the product with V1 of the REST API.
- Fixed the results of the Filter by price widget in a secondary currency (with automatic conversion).
- Fixed issues with updating order totals on the order edit screen.
- Fixed a fatal error with single function REST callback.
- Fixed an issue with erratic wrong child product transients.
- Fixed WooCommerce REST namespace detection.
- Fixed bundle items price while creating a new order from backend.
- Fixed compatibility with Name Your Price extension in version 3.0.
- WooCommerce Analytics Dashboard now will not display translated products separately.
- Fixed a conflict when using the wpml_sync_custom_field action hook on a product field.
- Fixed an issue with translating WooCommerce Table Rate Shipping rateâ€™s abort messages.
- Fixed an issue with the currency switcher not showing when a new language is added.
- Fixed scenarios for translated products in the WooCommerce Composite Products addon.
- Fixed translating singular labels for attribute taxonomies.
- Fixed the wrong product translation author when using the Classic Translation Editor.
- Fixed the product analytics pagination.
- Variation Swatches And Photos â€“ Fixed a bug when the custom attribute translation is the same as the original.
- Fixed a PHP notice from the currency switcher when an extra language is added.
- Fixed the checkout block redirecting to the wrong language for the confirmation page.
- Fixed the currency conversion when switching subscriptions.
- Fixed the encoding of base permalinks that contain slashes.
- Fixed an issue with Print Invoices/Packing Lists addon using the admin language instead of the order language.
- Improved the attribute taxonomy translation UI when itâ€™s not publicly queryable.
- Fixed a link pointing to the wrong admin screen to translate non-WooCommerce taxonomies.
- Fixed an issue with displaying the wrong product category count between languages.
- Added /order-pay/ to reserved endpoints for absolute links converting.
- Fixed the missing and/or duplicated emails with Dokan.
- Fixed missing product tabs comming from WooCommerce Tab Manager plugin.
- Better compatibility with plugins that manipulate the cart.
- Fixed not working product category order synchronization between languages.
- Fixed shipping country used instead of billing one when checkout.
- Increase minimum Woocommerce version to 3.9.0.
- Fixed error for “Fix translated variations relationships” troubleshooting option.
- Woocommerce Analytics Dashboard now will not display translated products separately.
- Added noindex/nofollow to all reviews page and link redirecting to it (filterable with wcml_noindex_all_reviews_page filter).
- Fixed not translated payment gateway title in new order admin email.
- Fix bought product in different languages.
- Fix when _product_image_gallery meta key contains an extra blank value.
- Set default language for orders while installation.
- Handling warning for rating for newly translated products.
- [WooCommerce Dynamic Pricing] Fix advanced category rules.
- Add Rest API support for more compatibility, like taxonomies, product variations, reports etc.
- Fixed not translated heading paid for Customer Invoice e-mail.
- Fixed all products block in secondary language.
- Override template only if it was not overriden before that.
- Added compatibility class for WOOF — WooCommerce Products Filter plugin.
- Fixed comment synchronization on duplicate content does not copy metadata of WooCommerce.
- Translate Composite Products scenario IDs data .
- Added a notice when multi-currency feature is enabled and an active cache plugin is detected.
- Fixed huge loading time for “Pay for order” Woocommerce page.
- Fixed an undue warning popup when leaving the multi-currency settings page.
- Make the currency switcher to appear on ‘my account’ page.
- Fixed interface glitches with Stripe payment and multicurrency.
- Fixing the link to edit translation in WooCommerce Translation Editor.
- Currencies and payment options based on location.
- Fixed notice after WooCommerce Currency was changed.
- Fixed not translated partial refunded email heading and subject.
- Fixed the WC Bookings email string not updated in the settings screen.
- Fixed a PHP notice when one language is not set inside the currency languages settings.
- Fixed a fatal error with MercadoPago addon on WC Settings page.
- Fixed the usage of
wp_redirectand take into account the returned value before to exit.
- Fixed empty attribute label for translations.
- Fix Redis cache when using Display as Translated mode and creating a variable product.
- Fixed a PHP Notice for some custom fields showing in the classic translation editor.
- Fixed the filter on wc_get_product_terms returning term names instead of slugs.
- Fixed multiple “Low stock” emails are not received by the admin.
- Fixed attribute label translation in German as a secondary language.
- Fixed not ended sale price in secondary currency if same sale dates uses from default.
- Fixed our gateways initialization on
- Fixed the WC Bookings reminder email that was sent in the wrong language.
- Fixed the WC Bookings email reminders sent multiple times.
- Fixed an issue creating empty “_gravity_form_data” post meta on product translation.
- Fixed no products on secondary language shop page if default language shop page contains special symbols.
- Fixed a performance issue due to comments filtering.
- Added new hook to Gravity Forms compatibility class.
- Manual shipping prices in secondary currencies.
- Fixed product attribute slug language not changed after changing value.
- Fixed missing numeric attribute values after translation using ATE.
- Fixed mini-cart total calculation when switching a currency.
- Fixed out of stock variable products if “Show only products with custom prices in secondary currencies” option is enabled.
- Fixed WC Tab Manager custom tab translation from ATE was not saved if the description is empty.
- Fixed an error which some additional plugins may cause with WC_Email object.
- Add a filter for WCML_WC_Gateways::get_current_gateway_language().
- Fixed not synchronized WooCommerce Tab Manager global tabs while saving product translation via ATE.
- Fixed not updated tax label after a change on settings page.
- Fixed the value of a custom attribute translation is overwritten on saving the original product.
- Fixed overwritten composite data title and description in translation after original product update.
- Fixed js console error in languages_notice.js file.
- Add language filtering for WooCommerce dashboard stock widgets.
- Fixed creating of several memberships in WooCommerce Membership plugin.
- Fixed JS SyntaxError on Products listing page.
- Fixed not registered ‘Additional Content’ emails setting text after first saving.
- Remove extra slash from the end of the translated base slug if a user added it.
- Fix custom fields translation in Translation Editor for Variations post type.
- Fixed customer Completed email has not translated heading and subject with WooCommerce 4.0.
- Fixed duplicated currency code in “Default currency” drop-down on Multi-currency settings page.
- Fixed language selector displayed in wrong place on Permalinks settings page.
- Fix customer order status email language when sent the shop manager use english language and english is not an active language.
- Fixed attributes synchronization may break variations relationships.
- Fixed not saved custom prices if translation is duplicated and Native screen editor selected.
- Fixed multiple same post meta keys translations.
- Add variation single “translatable” custom fields to translation package.
- Fixed error on Subscription renewal via PayPal.
- Fixed not saved The Events Calendar ticket meta if translation done by Translation Service.
- Replaced some Twig templates with pure PHP templates as the first step towards the removal of Twig dependencies.
- added comp. class to cover price update when products are edited with WOOBE plugin
- Added compatibility class for WooCommerce order status Manager plugin
- Fixed an issue where the strings for the default payment methods were not properly translated on the Checkout page.
- Fixed an issue with the cache flush during language switching.
- Fixed in the original ticket.
- Fixed an issue where the gateway strings would always register in English instead of the site’s default language.
- Fixed languages column width on products table.
- Fixed PHP Notice for WC Variations Swatches And Photos compatibility.
- WooCommerce Bookings compatibility : Fixed notice when trying to cancel booking.
- Fixed an issue where the total price on the Composite product page was not rounded.
- Fixed an issue causing wrong rewrite rules after saving the settings and visiting a page in a language other than the default.
- Fixed an issue with incorrect price converting for the Product add-ons.
- Fixed an issue with the WooCommerce Subscriptions availability in the secondary language after purchasing the subscription in the original language.
- Fixed an issue with the currency reverting to the default one during checkout.
- Fixed removed meta from original product not synchronized to translation.
- Fixed an issue where the BACS gateway instructions were not translated when re-sending the customer notification email from the admin.
- Fixed an issue with missing language information for attribute terms that happened after changing the attribute slug.
- Removed the Twig Composer dependency as it now relies on Twig from the WPML core plugin.
- Fixed an issue where customers would not receive notifications in the correct language.
- Fixed an issue where the Products shortcode was not working in the secondary language.
- Fixed error while sending WooCoomerce Bookings email for bookings which didn’t have orders assigned.
- Added compatibility for free version of YIKES Custom Product Tabs.
- Updated compatibility class for WC Checkout Addons
- Fixed the images that were wrongly inserted in the translation job when attachments are not translatable.
- Significantly improved the site performance on when updating the page, post, or a WooCommerce product page in the admin.
- Added the “wp_” prefix to all cookies so that hosting and caching layers can properly handle them.
- Fixed an issue where the “Fix translated variations relationships” troubleshooting option was removing translated variations.
- Fixed an issue where product names were not translated in the admin emails.
- Fixed an issue with the price filter widget not showing results in a secondary language.
- Fixed an issue where the shipping classes in secondary languages were not calculated during checkout.
- Display larger images when hovering thumbnails in the WooCommerce Multilingual Products admin page.
- Added the “wcml_new_order_admin_email_language” filter to allow setting the language of emails sent to admins for new or updated orders.