How to Upgrade
This document gives a general overview over the hyva-checkout upgrade process.
Please be sure to check the version specific upgrade notes.
The Upgrade Process
- Check version specific upgrade notes here in the docs. If there are any backward incompatible changes they will be listed there.
- Check the changelog for the new version.
- Upgrade the
hyva-themes/magento2-hyva-checkoutmodule. - Apply required changes from step 2. to files customized in your theme.
Frontend API Compatibility
If you are running an older version of Hyvä Checkout and your payment methods rely on the latest Frontend (Payment) JavaScript API, you must install the hyva-themes/magento2-hyva-checkout-frontend-api (standalone) package to ensure proper functionality.
Whether this package is required depends on your specific use case and setup. It is not always necessary. The module exists to allow payment module developers to use the latest JavaScript API without having to account for differences between Hyvä Checkout versions or missing functionality in older installations.
As a general rule:
- If you are using an older version of Hyvä Checkout, keep this package installed and up to date.
- If you are running the latest version of Hyvä Checkout, this package is no longer required.
Upgrade composer command
To update the hyva-checkout package including its Magewire dependency to the latest version, run the command
To update to a specific version, use the following command, while replacing x.y.z with the desired version.