# Email or SMS provider template broken: pre-release checklist

Source: https://releasefailures.com/incidents/email-or-sms-provider-template-broken/
Content version: 1.0.0
Verified on: 2026-10-22
Licence: CC BY 4.0

Definition: Transactional messages are sent with broken templates or to wrong recipients after a template change.
- [ ] PR-01 Add a unit test that renders PASSWORD_RESET_CONFIRM and every review template and fails on any variable, such as lostPasswordUrl, that has no registered value. (test class: Unit tests)
- [ ] PR-02 Add a unit test that fails when a localized body of PASSWORD_RESET_CONFIRM uses a variable name absent from the default body. (test class: Unit tests)
- [ ] PR-03 On a fresh install, send the password reset email with the mailer set to log and confirm the log shows a reset URL and no unreplaced variable. (test class: Integration tests)
- [ ] PR-04 Repeat the password reset email test on an install upgraded through the migration script and confirm both installs render the same template. (test class: Integration tests)
- [ ] PR-05 Send a signing invitation through the updated email script version in staging and confirm the received body contains text and an invite link. (test class: Integration tests)
- [ ] PR-06 Roll back the email script version in staging and confirm the restored version sends signing invitations with correct mail templates. (test class: Integration tests)
- [ ] PR-07 Add an end-to-end test that requests a password reset, opens the received email, follows its link and sets a new password. (test class: End-to-end tests)
- [ ] PR-08 Add an end-to-end test that creates a signing transaction, opens the invitation email and finalizes the signature through the invite link. (test class: End-to-end tests)