Translating Product Catalog
page last edited on 09 February 2018
X-Cart keeps the store text content in labels, and the product catalog content is not an exception. To translate your store catalog into another language you will need to add text labels and their values in another language for the respective labels in English, e.g. category and product names, category and product descriptions, etc.
Before translating your product catalog make sure the respective language package is installed.
There are 3 possible ways to translate a product catalog:
Using the Store Admin Area
If you need to translate (or to edit the existing translation) of one or several products and/or categories, you can do this directly in the store Admin area.
For this purpose:
Locate a product or category you need to translate and open the its details page:
Switch the language of the Admin area to the target language of your translation:
Edit the required product/category info:
Save the changes.
That’s it! The product/category details will now displayed in the required language when the language is switched.
Use this method to translate product and category details, product classes and attributes, products tabs, tags and brands.
Using Description Editor Tool in the Storefront
The Description Editor tool of the Theme Tweaker addon allows you to edit product and category descriptions directly in the storefront. Hence you can use it to add a description of a product or category on another language or translate an existing one if required.
The Description Editor tool can be used for editing product and category full and brief descriptions only. If you need to translate more product details into another language, use the tools of the store Admin area.
For this purpose:
Locate a product or category you need to edit and open the product/category details page in the storefront:
Switch the storefront language to the target language of your translation:
Edit the required product/category description using the Description Editor tool as described here:
Save the changes.
That’s it! The product/category description will now display in the required language when the language is switched.
Use the Import-Export feature when you need to translate your store product catalog as a whole. Export the existing categories and products into a .csv file, edit this file and then import it back into the store.
Using this method you can translate product and category names, as well as brief and full descriptions and the rest of details you need.
To translate a product catalog:
- Export the current catalog data:
Go to the Export page of your store Admin area (Catalog -> Export):
Export data as described How to Export Data.
As a result, you will get a .csv file with the default labels’ names and their values.
Open the exported .csv file in any spreadsheet editor (MS Excel, LibreOffice Calc, etc.)
Delete all the tables except for SKU and the tables marked with EN (the labels marked with EN can be translated and imported back).
You should get a file content similar to the following:
Rename the EN tables to match the target language (e.g. name_en to name_de if your target language is German).
Fill in the new tables with the translation (e.g. the name_de table should contain the name of a product/category in German).
As a result, you will get a file similar to the one shown below:
- Save the .csv file with the SKU and DE tables and import it back to your store as described in How to Import Data.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.