Skip to main content

Migrating from Toolkit Version 1

Version 2 of the toolkit brings several design and functionality updates to the components. Migration is recommended in order to access the full suite of current and upcoming Reflow features.

To import the new version you only need to change the versioning number of the CDN links:

# Replace:
https://cdn.reflowhq.com/v1/toolkit.min.js
https://cdn.reflowhq.com/v1/toolkit.min.css

# With:
https://cdn.reflowhq.com/v2/toolkit.min.js
https://cdn.reflowhq.com/v2/toolkit.min.css

Breaking Changes​

Upgrading from v1 to v2 will keep most of the existing toolkit functionality as is, without requiring changes to your code.

However, there are a couple of issues to look out for when upgrading:

  • The Product component now displays the product's categories as links under the product title. If you wish to hide them so that your product page looks the same as it did with v1 of the toolkit, use the show attribute and omit "categories" from the list.
  • An "Add to Cart" button is now shown on products in Product List. If you wish to hide it use the show attribute and omit "add-to-cart" from the list.
  • The HTML structure of the Cart component was changed to streamline the checkout into a single step. If you've written custom CSS to overwrite the styling of the cart, you will likely need to update your code.

Support Policy​

Version 1 of the toolkit will continue working indefinitely, however it won't receive any further features or bugfixes. For new projects we recommend using v2.