If you are currently using the original langify app and would like to migrate to the new version, please contact us. We will then enable the Update button for your store. Before proceeding, please prepare your current langify setup as described below.
Since the update can be complex, we recommend contacting our support team at support@langify-app.com beforehand. We may request collaborator access to your store’s admin area, we can offer faster support if any issues occur.
IMPORTANT: Please note that depending on your theme, installed apps, and configurations, you may need to adjust some translations manually. There are some breaking changes between both langify versions and in some cases translations have to be added in another section.
Quick Guide
The update is straightforward, but a few manual steps are required.
It is recommended to read the complete guide, but here is a quick overview of what steps to expect:
- Export your translations as a backup from langify
- Create a langify-free copy of your live theme (langify -> Theme Settings -> "create a new theme without langify code") and set this as your new live theme.
- Click on the yellow "Update" button in langify and wait for the process to finish
- Migrate the product variant translations manually by importing the product translation backup into the Product section in langify
- Assign your languages at Shopify -> Settings -> Languages
- Publish langify as embedded app on your new live theme
- Add a new language switcher via the new Switcher Configurator in the langify dashboard
Complete Guide
Below you will find a complete guide on all necessary steps and further reading references.
If you have any questions or concerns about this, don't hesitate to reach out to our support.
Before the Update
Before you start the update, make sure to complete the following preparatory steps.
1. Export your translations as CSV or PO ( Exporting Translations (v1) )
2. Create a langify-free copy of your current theme.
This can be done at langify -> Theme Settings -> click on "create a new theme without langify code". This option will not edit your live theme but instead create a copy of it that is free of the old langify translation code.
Afterwards, please preview this theme in Shopify to make sure the clean-up was done correctly.
If any custom modifications were done to the langify translation code, then those have to be cleaned up manually.
If you see any errors or encounter unexpected behavior, please reach out to our support so we can have a closer look.
3. Optional: If you have previously used langify's Domain Feature to have separate domains for your languages, please note that for the new langify app version the domains are managed via the Shopify Market section. It might be a good idea to familiarize yourself with this section before the update.
You can find further reading material on the Shopify Market settings at:
How to assign languages to domains/markets or
https://help.shopify.com/en/manual/markets-new
Starting the Update
To trigger the update click on the yellow "Update" button in the langify app header.
If the "Update" button is not available, just reach out to our support to have it enabled.
It might be possible that langify asks for new app permissions. If so, please accept them or ask the store owner to accept them. Afterwards, trigger the update again via the "Update" button in langify.
If langify gives an error notice that the update cannot be started, this usually has two possible reasons:
- Domain Feature is enabled: Please reach out to our support and we will disable this for you
- ISO code is not supported: Please check your language settings in langify and change the ISO code of the language if necessary
During the Update
Depending on how much content your store has, the update can potentially take a while. Please wait for the process to complete and avoid closing the browser tab.
Translation Migration
Most of your translations will be migrated automatically during the update process - there are unfortunately a few exceptions:
Product Variants: Shopify recently overhauled their variant structure which is why langify is not able to migrate their translation automatically anymore.
After the update has completed, please use the translation backups you created beforehand and import the product translations into the Product section. This will restore the variant translations.
Notifications: Because Notifications can now be translated natively instead of the previous workaround, their translations have to be set up again after the update in the new Notification section in langify.
Images: If you have used the Image section to translate your images, these translations are unfortunately lost upon an update, because the image translation has fundamentally changed and there is no direct equivalent to the Image section in the new langify app.
In the new langify app version you will be able to translate these images either in the Theme section or via Custom Content.
After the Update
1. Check whether all translations were successfully migrated, and use your translation backups if necessary.
2. Assign your translation languages in Shopify. This can be done by going to Shopify -> Settings -> Languages
If you want to use different domains for your languages, then the domains have to first be configured in the Shopify Market settings.
3. Publish the new langify app version on your cleaned theme and set this as your new live theme.
With the new langify version, publishing is just a few clicks with virtually no waiting time. Please see our guide Publishing langify for a comprehensive overview.
If you do not have a langify-free theme, please reach out to our support so we can provide you with a langify-free copy of your theme.
4. Add a new language switcher to your theme. If you need any assistance with this, please don't hesitate to contact our support team.
The update has now been successfully completed!