Slides: https://speakerdeck.com/shyim/the-shopware-update-playbook
- Check that the server requirements are met by current and new Shopware version
- Fix already existing deprecations in
var/log - Fix reported errors by
shopware-cli project validate - Add Twig Block Versioning. Blog Post
- Check that all installed extensions are really in use
- Check that all installed extensions are compatible with the new Shopware version (
shopware-cli project upgrade-check) - Migrate installed extensions to Composer. Docs Docs
- Migrate project to Symfony flex Docs
- Use automated fixers like Rector, ESLint to fix common deprecations Docs
- Use AI to upgrade Twig templates Docs
- Take advantage of AI Agents like GitHub Copilot, Cursor, Claude to upgrade common deprecations in various frameworks like Bootstrap,
- For Project customizations, prefer a single Symfony/Shopware Bundle over creating multiple plugins
- Keep the extension simple, just because Shopware is doing something in a way, doesn't mean you should do it the same way.
- For customizations, prefer to use configuration/events over decorations. Events are more stable and easier to maintain in future and can reduce the risk of breaking changes.
- The effort is the same if you update every two years or more frequently. The changes you have to do are the same, but the effort is much higher if you wait longer. So better update every 6 months.