Some releases need a quick migration check because an API or default changed. Choose your target version below, and follow the older guides in order if your application is several major versions behind.
Migrating to 9.2
Version 9.2 changes governance-builder call order, asynchronous failure reporting, serialized email snapshots, configuration precedence, and several security defaults.
Review the 9.2 changesMain work: fix moved builder methods, review changed async and serialization behavior, then check TLS trust, embedded-image bases, DKIM exclusions, and S/MIME status handling.
Migrating to 9.0
Version 9 consolidates the dedicated recipient-builder API and requires the most code changes. Start here when moving from 8.x.
Open the 9.0 migration guideMain work: replace removed recipient overloads, review behavior changes, then compile and exercise your message-building tests.
Migrating to 8.0
Version 8 moved defaults and overrides out of the email builder and into Mailer governance.
Open the 8.0 migration guideMain work: review when defaults become visible, replace the removed default S/MIME methods, and check advanced conversion code.
Historical major migrations
If your application predates version 5, follow each major-version guide in order instead of jumping straight to the newest examples.
Release history
Use GitHub Releases and the repository's complete release history for changes that do not require dedicated migration guidance.