When upgrading your application from an older Wicket version to a newer one, you may encounter API changes. The migration guides document all the changes between versions and provide clear upgrade paths.
If you encounter a change that is not covered in a migration guide, please let us know on the developer mailing list.
Available Migration Guides
- Wicket 10 Migration Guide — Upgrading from Wicket 9.x to 10.x (requires Java 17+)
- Wicket 9 Migration Guide — Upgrading from Wicket 8.x to 9.x (requires Java 11+)
- Wicket 8 Migration Guide — Upgrading from Wicket 7.x to 8.x
- Wicket 7 Migration Guide — Upgrading from Wicket 6.x to 7.x
General Upgrade Advice
When upgrading, we recommend:
- Read the migration guide for your target version before starting.
- Update your Maven or Gradle dependency to the new version.
- Address any compilation errors — these indicate removed or renamed APIs.
- Run your test suite to catch behavioural changes.
- Check the mailing list archives if you encounter unexpected issues.