However, since the two versions work slightly differently, you need to follow these steps to successfully upgrade.
Step 1: Converting Designs
Since Clerk.js 2 has a different approach Designs, you need to create new ones.
You can create your Clerk.js 2 Designs in one of two ways:
- 1. Use the intuitive Design Editor to create new Designs, as described in the following points.
- 2. Convert your old Designs. Follow this guide to see how to do it.
1.1 Start by going to my.clerk.io -> Recommendations / Search -> Designs and click New Design:
1.2 On the following screen, give your Design a Name (we recommend adding "V2" so its obvious that you are using Clerk.js2).
1.3. Choose Design Type: Product Slider (Design Editor), Exit Intent or Product Slider (HTML).
1.4. When you are done, click Create Design
1.5. In the Design Editor, click any of the existing elements like the name, image, button, etc. to edit it, or drag-and-drop new elements to the Design to add more information about products.
1.6. Click Save Design when you are done, and go to Step 2 in the guide.
1.7. Lastly, go to Recommendations / Search -> Content and change your Clerk.io Content to use your new Design.
1.8. Click Update Content. This will temporarily cause them to not show up on your webshop until you are done with Step 2. Choose the new Design for all Content that should be updated.
1.9. There! You are now ready to switch over to Clerk.js 2.
Step 2: Upgrading your module
WARNING: Remember to take backups of any modified files, as they will be overwritten.
Start by downloading the latest version from this link:
Then log in to your Prestashop admin and go to Modules And Services -> Modules And Services
On this page, do the following:
2.1. Click Add New Module
2.2. Click Choose a file and upload the clerk.zip file you just downloaded
2.3. Click Upload this module
PrestaShop will now display a success message, confirming that your module has now been upgraded.
Now you have the latest version of Clerk.io for Magento 2 installed, and Clerk.js 2 is running on your webshop!
The full documentation for Clerk.js 2 can be found here: