Version 3 of affiliate-toolkit stores product data in its own database tables, splits the shop interfaces into modules and uses Blade templates. If you still run version 2.8.9 or older, follow these steps once. Everything you need is built into the current base plugin.
Create a complete database backup before you start. The migration rewrites your product data.
1. Replace the plugin and install the modules
- Deactivate and delete the old plugin, then install the current base plugin from the WordPress plugin directory (see Install affiliate-toolkit).
- Install only the modules you really need – for example Amazon, AWIN or CSV Feed. Every additional module adds code that has to be loaded. You find them in your customer account and on the extensions page.
- Activate the licenses under affiliate-toolkit → Settings → Licenses.
2. Migrate your products
Open affiliate-toolkit → Tools → Debug. The section Migration from v2 to v3 offers two buttons:
- Migrate my products (including productdata) to V3 – if you did not change product data such as title, brand, description or features by hand. The data is loaded fresh from the shops.
- Migrate my products to V3 – if you did change product data. Your own texts are kept.

Wait until "finished" appears at the end of the page. If you get an error or a timeout instead, click the same button again – repeat until you see "finished". The duration depends on the number of products.
After the first migration, titles and texts can be empty for a while: the plugin reloads all product data from the shops in the background.
3. Refresh shops and remove old interfaces
- Open every AWIN and CSV shop once and save it again.
- The old Belboon and "Live CSV" interfaces no longer exist. Delete these shops and replace them with a shop of the CSV Feed module, using the network's product feed.
- If you used the old CJ interface, recreate the shop with the current CJ module.
4. Mark everything for update
Still under Tools → Debug, click Mark all CSV shops for import, Mark all products for update and Mark all lists for update. The cronjob then puts all shops, products and lists into its queue and processes them. This can take a while – make sure your cronjob is set up correctly (see Set up the cronjob for product updates).
Check the progress on the queue page. Every run is listed with its status and any errors.

5. Old templates
Templates with %placeholders% from version 2 are not rendered by the base plugin any more. You have two options:
- Install the Template Compatibility module. Then open each affected template under affiliate-toolkit → Templates, switch its type to Old template and save.
- Or convert the template to Blade: Migrate a classic template to a Blade template.
6. Clean up the cache folder
Finally, delete all files in /wp-content/uploads/affiliate-toolkit/ via FTP or the file manager of your host. Then open Settings → Display settings and save once, so the files are generated again.