In this article, we will go over the options that are available to you when it comes to adding more than one language to your Product Finder.
Last updated
To begin, select Product Finders from the sidebar on the left side of the screen and navigate to your Finder. Finally, click on the Translations tab. There are two options for editing your translations:
Bulk Upload via CSV file (ideal for when you want to make many changes at once)
Editing in the Crobox App (ideal for when you want to make small changes to a small number of fields at a time)
Before you use either a CSV upload or manual editing via the app, there are a few things you should know.
The first step in having multiple languages for your Product Finder is to add a new language. You can do this by clicking on the Edit languages button on the Translations tab, as shown in the screenshot below.
The options you will see in this dropdown will depend on the Regions that have been set up for your account.
We recommend that you do not add a “translation” for the default language. For example, if the Product Finder is set up in English, there is no need to add an English “translation”. The reason we recommend against this is because this addition will result in more manual changes on your end to reflect edits to the Product Finder.
You will see everything as a translatable field including images and colors.
The Product Finder will always fall back to the default for these fields. This means you should not add a translation for this field unless the image is different in a particular language.
If you do add a translation for an image field, you will need to remember to update this manually if you ever change the image in the future.
If you are adding/changing many translations or multiple languages, the easiest method is through the CSV file upload option.
Navigate to the Translations tab, click on the three dot menu --> Download Translation CSV. This is shown in the screenshot below.
The first column - key - should not be changed, moved, or removed. This is essential for uploading the file once your edits are complete.
Once you have downloaded the CSV file, you can manually edit any of the fields.
Do not change the first row with the language codes. You can re-order the columns (or remove specific columns if you are not updating those translations). The only translations that will be updated will be fields where the column language key (for example nl) and the row field key (for example page.landingPage.title) match a language and field that are in the system.
If you remove a column (language) from the file and then upload the CSV file to the app, this language will not be affected.
If you remove a row (field) from the file and then upload the CSV file to the app, this field will not be affected. Removing a row will not delete the translations of this field.
If you want to delete translations, you should clear out the values in the row, leaving the field key (first column) as-is.
Once you have made all the changes, save the file as a CSV. Then click Upload translation CSV, as shown in the screenshot below.
You will immediately see the updates in the content on this page. Once you click Save, those changes will be saved to your Finder.
If you are editing a Product Finder that is live, do not forget to publish a new version so the changes can be displayed in the live environment. You can find more information about publishing versions by clicking here.
If you only need to make a couple of changes to the Finder translations, you can easily do this in the Crobox App in the Translations tab.
You can use the arrows on the top left to flip through different languages for a given page, or you can select a language from the dropdown menu, as shown in the video below.
You can use the arrows on the top right to flip through the different pages for a given language, or you can select a page from the dropdown, as shown in the video below.
If you don’t see a language in the Translations tab that you expect to see, please contact your Customer Success Manager so they can assist you.
