Translation FAQ and How-to

Is Libersy Webshop available in other languages than English? Can it be translated?

Yes, Libersy Webshop is available in many languages. The list of available translations is below.



Brazilian Portuguese ,Bulgarian, Catalan, Chinese, Croatian, Czech, Danish, Dutch,

English, Estonian, Finnish, French, German ,Greek, Hebrew, Hungarian, Icelandic, Indonesian,

Italian, Japanese, Korean, Latvian, Lithuanian, Macedonian, Marathi, Norwegian, Persian

Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, 

Spanish (Latin America), Swedish, Thai, Turkish, Ukrainian, Vietnamese, Welsh, Belorussian,
Albanian, Basque 



You can check how this translation works in our demo store. Change the language in the top right corner of that page.



English, Russian, French, German, Italian, Dutch, Hungarian, Norwegian, Spanish, Portuguese, Romanian

More details about these translations are available in the "Backend translations" article.


All translations are contributed by Libersy Webshop users. Many thanks to them!



How do Libersy Webshop built-in translations work?

A customer will see the language, which is most suitable of all the languages enabled by the store owner. This language will be automatically set based on the customer's browser settings. If there are no appropriate languages enabled, the default language will be shown. As a result, in most cases, your customers from any country will see your store in the languages they speak automatically. They will not even need to select anything.



How can I enable built-in storefront translation?

Built-in translations can be enabled on the "System Settings → General → Languages" page in your Libersy Webshop backend.



How can I enable backend translations?

Backend translations are still in beta, thus they're not available by default. Please refer to this article for instructions on how to enable them.

If you want to translate Libersy Webshop backend to a new language, please contact us



I found some issues/typos/errors in your translations. What should I do?

Create a new thread on our forums and post your corrections. We will update the translations.



How to translate my Libersy Webshop store to a new language?

  • First please translate Libersy Webshop to your language. You'll find the label names and the default values in this file: Libersy Webshop_labels_13_1_eng.txt   
  • Then make sure that the translation doesn't have any errors or typos.. 
  • Translate the following button labels (please do not use long texts): 
    • "Add to Cart"
    • "Continue Shopping"
    • "Place Order"
    • "Checkout" 
  • Send all the information to us: After that we will add your translation to the list of Libersy Webshop translations. Thank you in advance!



How can I force language selection in my store?

By default a customer sees the language, which is most suitable of all translations enabled by the store owner. The language is automatically set based on the customer's browser settings. This way is great because your international customers will always see your store in their preferred language, so it will be much easier for them to place an order. Easier checkout = more sales. However in some cases it is necessary to show store in a specific language regardless customer's browser settings. How to do this: 


1. If you want to make your store always displayed in one language, then just disable all translations except for the necessary one. After that your store will be always displayed in this language.


2. The other way is to force language selection by passing a special argument to the Libersy Webshop widgets. You should add the new "lang" GET variable to all inclusions of the "script.js" file: 


<script type="text/javascript" src="" charset="utf-8"></script>


where YOUR_STORE_ID is your Store ID and LOCALE_CODE is the code (the two-letter codes "ISO 639-1" should be used) of the necessary language, for example enes, fr, deThe list of language codes. Please note that the selected language should already exist in Libersy Webshop and be enabled in the control panel.



<script type="text/javascript" src="" charset="utf-8"></script> 



How do Libersy Webshop translations via JavaScript code work?

Using special files or JS code you can override any Libersy Webshop's text in storefront.

You can use this feature if you want to: 

  • translate Libersy Webshop to a new language
  • change any its text

Important note, if you translated Libersy Webshop using this method, it will override all the settings on the Languages page.



How can I change or translate any text in my storefront?

It is possible to change any text in your Libersy Webshop storefront. You can use this feature to translate your store or to make the labels more suitable for your individual Libersy Webshop setup.

In order to do it you just need to add a special JavaScript code with the updated labels before the Libersy Webshop integration code.

The format of such a code is:

<script type="text/javascript">

ecwidMessages = { "LABEL_NAME":"LABEL_VALUE", 

LABEL_NAME is the internal name of the text label. LABEL_VALUE is the text that is shown in the storefront. You'll find the label names and the default values in this article: 


The important things you should pay attention to are:

  • each line must be ended with comma except the last line
  • do not leave empty lines in the Javascript code
  • the special chars should be escaped. For example if the value of a label has double quote(") it should be escaped with the slash(\")
  • some buttons are actually images, so you cannot translate them using JavaScript. Use the custom CSS code to replace the images
  • keep HTML tags in the label values, they're necessary for the correct Libersy Webshop work
  • pay attention to the spaces after the label values. Some labels have it.  So make sure that they won't be loaded durign the translation.
  • UTF-8 charset is strongly recommended
  • if you don't like to insert many JS lines to your store page, you can move them to the external JS file:


If you're not familar with the JavaScript, but want to translate your store or change its labels, please use the Libersy Webshop Translate Tool. It will make the translation much easier. Just insert new values, press "Generate" button and copy the generated code.



E.g. we want to replace the "Shopping Bag" text with "Shopping Cart" in the bag widget and "your bag" page. 

So we need to add the following code before this line: <script type='text/javascript' src=''></script> on your web page:


<script type="text/javascript"> ecwidMessages = { "BreadCrumbs.your_bag" : "Your shopping cart", "Minicart.shopping_bag" : "Shopping Cart", "ShoppingCartView.shopping_bag" : "Your Shopping Cart", "EmptyShoppingCartPanel.empty" : "Your Shopping Cart is empty" }; </script> 

Then refresh a page and check the result.


How do I apply a custom translation in Joomla?

Libersy Webshop allows for custom changes to the built-in translations by using a special piece of JavaScript in the source code of your shop page, as described above. If you embed Libersy Webshop manually, by copying and pasting the code from the Dashboard page of your Libersy Webshop control panel to the HTML source of your page, then the translation code needs to be inserted likewise into the HTML source code of that same page.


However, when you use a plugin to embed Ecwid into Joomla, you cannot just edit the source code of your shop page, because it is fully generated by the plugin and the template of your Joomla. In this case you need to put the custom translation code into a new 'Custom HTML' module in your Joomla and then publish that module in any position on the shop page or even on all pages of the site (it will not harm anything). This way the custom translation code will get into the shop page source code and your custom labels will work.



How do I apply a custom translation in Wordpress?

The code for your custom translations should be placed in the HTML code of Wordpress page where your Libersy Webshop store is installed. If you embed Libersy Webshop manually by copying and pasting the code from the Dashboard page of your control panel to your store page, then the translation code needs to be inserted likewise into the HTML source code of that same page. On the other hand, if you use our ready Wordpress plugin, it creates a special page for the store. In your WP Admin → Pages it can be usually found as a page entitled 'Store'. You need to go editing the store page, switch your editor to HTML mode (a gray tab on the top right of editable area) and paste the code for your custom translation in there. Then you need to apply the changes by pressing Update button on the right column and then see your store, your custom translation should be visible then. 




I've installed a translation using a JS code, but some text is still in English

It looks like the translation file was created for an old Libersy Webshop version. Since that time, some new labels have been added. You can translate them using a special tool and post them into a new forum thread — we will update our language packs.

I've added a translation using a JS code, but the whole store is still in English

Usually it happens for the following reasons:
  • you uploaded the file with translated labels to an incorrect directory, so it cannot be loaded
  • the JS file with translated labels has some JavaScript syntax errors
Post a link to your store and we will look into the issue.

I've added a translation using a JS code in Joomla, but it doesn't work. Joomla editor removes any script I put in it. 

How can I translate or change buttons?

All Libersy Webshop images can be changed via CSS. Please refer to these articles for more information: 
If you need PSD source of the button images to translate them, take this archive: psd_for_default_skin.tgz
(PSD files are © 2009 Creative Development. But you are free to alter and use them as long as you do that for purposes of customizing your Libersy Webshop store) 

How can I translate country names?

Each text in Libersy Webshop has its own label. You can override these labels to add your own texts, translations, etc.

All country names labels have the following format: Country.COUNTRY-CODE

where COUNTRY-CODE is a two-letter ISO code of the necessary country:


For example, you want to translate the name of Norway. The Norway code is NO.

So the label name is Country.NO.


The payment methods in my store are not translated. How do I translate the names of the payment methods? 

The names of the payment methods are the data of your store, similar to product names and category names. They are not included into official translations of Libersy Webshop and do not have to be translated with the code. Instead, you can translate them in your Libersy Webshop control panel as described here: How to change a name of any payment method?


My mail notification templates are in English. How do I get my mail notifications translated to my language?

The mail notification templates in Libersy Webshop are basically the data of your store, just like the product names or category descriptions. Libersy Webshop creates the mail notification templates in the language that you use when you see the Libersy Webshop control panel for the first time after signing up with Libersy Webshop. So, mail notifications may contain English texts even if you are using another default language in your store.


You can easily change the mail notification templates in your store in Libersy Webshop control panel → System settings → Mail. 


If you are using the Libersy Webshop control panel in your native language other than English, and that is the language you want your mail notifications to be translated into, you can take the following steps to quickly translate your mail notification templates:

  1. Go to  Libersy Webshop control panel → System settings → Mail.
  2. Edit each notification template - click [Edit Message] next to each notification in list
  3. Press 'Revert to system default' button on the bottom left of the editing dialog, then press Save
  4. Repeat steps 2-3 for each of your notification templates
  5. Press Save in the top right of the page 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Powered by Zendesk