How to translate Merchium

Modified on: Mon, Apr 7, 2014 at 11:21 AM

Before creating a new language, check if it already exists on CS-Cart translations project To add a new language from to your installation, do the following:


  1. Go to and choose the desired project.
  2. On the opened page find the desired language and click on its name.
  3. Click on the Export link in the left corner at the bottom of the page. Save the file.
  4. In the administration panel of your store go to Administration > Languages > Manage languages.
  5. Click the + button in the left upper corner of the page to add a language.
  6. On the opened page upload a language file in the PO format that you have previously downloaded from
  7. Click the Install button. The new language will appear in the list of installed languages.

To create a new language:

Note: Make sure that there is no such language among the list of available languages in Administrtation > Languages > Manage languages in the Available tab, and there is no such language at
  1. Go to Administration > Languages > Manage languages.
  2. Click the gear button of any existing language and choose Clone. In the opened pop-up window enter the two-letter language code. A new language will be added to the Installed list (it will be the copy of the existing language). The select box allowing users to choose a language will be displayed in the customer area and in the store administration panel.
  3. Click the gear button of the newly created language and choose Edit from the drop-down menu.
  4. Set up the given fields and click the Save button.

Most of Merchium texts are stored in the so called language variables. Although, they all can be viewed and edited under the Translations tab of the Languages page (it is in the Administration menu), we recommend to translate them in the following order:

  1. In the administration panel, go to Administration > Languages > Translations.
  2. Click the gear button in the right upper corner of the page and choose On-site text editing from the drop-down menu. You will be redirected to the storefront and will need to translate the text with the following icon on the left:
  3. To do it, follow these steps:
    1. Click on the icon, select the desired language in the top right corner of the opened pop up window and enter the desired text in this language.
    2. Click on the Update text button.

  4. After you translate all visible texts, some language variables are still not translated as they are displayed in the e-mail notifications and in some special situations, i.e. error notifications, popup window messages etc. In order to translate the rest of the variables:
    1. Go to Administration > Languages > Translations and select the newly created language in the select box in the top left corner. Now you are assumed to edit the text variables for this language.
    2. NOTE: If English is selected in the select box, you will edit texts in English on the page.
    3. Translate texts in the Value input fields of the language variables on the page.

      NOTE: Do not translate words written with lowercase words in square brackets, i.e. [link]; [product]; .... When this text is displayed in the storefront, such a variable will be replaced with an appropriate value automatically (e.g. [product] will be replaced with the corresponding product name). Namely, the word between square brackets is just a spot indicating where Merchium should place the appropriate value. So move it within the text, but do not delete. Translate the words written with uppercase letters in square brackets, i.e. [ALREADY PATCHED], [DELETED], [FAILED], [NON WRITABLE], ... They are the notifications generated by Upgrade Center and should be translated as well.
    4. Click on the Save button to save the changes.
      NOTE: It is required to save the changes on each page with the translated language variables. If you open the next page with language variables without clicking on the Save button on the previous page, translations on your previous page will be lost.
  • Then it is necessary to translate the content of the following pages in the administration panel as they affect the storefront too:
    • Administration > Order statuses
    • Marketing > Gift Certificates > Gift Certificate Statuses
    • Administration > Profile fields
    • Customers > User Groups
    • Administration > Shipping & Taxes > Shipping Methods
    • Administration > Shipping & Taxes > Countries
    • Administration > Shipping & Taxes > States (if required)
    • Administration > Payment Methods
    • Administration > Currencies
    • Design > Layouts
    • Website > Content > Forms (the Contact us page)
  • Also, it might be required to translate the following pages if there are any entries on them (it can be the result of enabling the corresponding add-on): 
    • Marketing > Gift Certificates
    • Orders > Return Requests > RMA Request Statuses (translate this page if you plan to use the RMA add-on)
    • Marketing > Banners
    • Website > News
    • Products > Products
    • Products > Categories
    • Products > Features
    • Products > Filters
    • Products > Options
    In order to translate the entries on the pages listed above:
    1. Open the necessary page and select the desired language in the language section in the top left corner of the page.
    2. Open the entry (e.g. order status) editing page and enter the necessary information in the selected language in the opened window.
    3. Click the Save button.
    4. Repeat points 2-3 for the other entries on the page.
  • NOTE: We recommend you closing the store when the On-site text editing is enabled, because some debugging information is displayed on the storefront then and it may confuse your customers.

    Did you find it helpful? Yes No

    Can you please tell us how we can improve this article?