Upgrading @pack/hydrogen
Each guide covers one major version, starting from the version before it. If you are more than one major version behind, follow them in order, oldest first: a storefront on 3.x makes the 4.0 changes, then the 5.0 changes. You can install the latest version once you have made the theme changes from every guide in between.
Upgrade between A/B tests, not during one. Both 4.0 and 5.0 change which tests a visitor can be in at the same time, so a test running across the upgrade mixes two populations.
| Guide | Starting from | What changes |
|---|---|---|
| Upgrading to @pack/hydrogen 5.0 | 4.x | Tests that change different content serve together. Your own testing tool can assign visitors. Stricter cookies in 5.0.1 and 5.1.0. |
| Upgrading to @pack/hydrogen 4.0 | 3.x | A visitor joins every test they qualify for. Personalization and visitor consent. A/B test hooks take a test handle. |
Still on Remix, with a @pack/hydrogen version before 3.1? Follow the
React Router 7 Migration
guide first. It brings you to 3.x.
For every change in every release, see the @pack/hydrogen changelog.