1.4.0
November 12th, 2026
Added
--submitsends a real submission and tests the whole path. For forms whose notifications come from a CRM automation rather than Statamic, a normal run could only check the CRM was set up.--submitsubmits each form through Statamic's own form request and controller, from a new plus address made from--to, so validation, the honeypot, the form's listeners and the real queue all run. It then waits for the test contact to reach each integration withcanaryContact(), which proves a queue worker ran the job, and queuescanaryDelete()forCANARY_DELETE_AFTERminutes later (15 by default), once the integration's automations have sent. It only runs on forms listed incanary.submit(CANARY_SUBMIT).--real-recipients, with--submit, sends the form's own emails to their real recipients, markedTEST:, to test a site's real routing.canarySample()lets a listener give--submita value the sample can't, such as a real product ID for a hidden field.CANARY_FROM_NAMEsets who test submissions say they're from. It defaults to D3 Creative.
Changed
- Sample data never mentions Canary. Message fields say "Test submission from D3 Creative. Please ignore." and text fields say "Test submission", in emails to the test address too, which said "Sent by Canary. Please ignore.".
- A text field with an
emailrule gets the test address, not just one withinput_type: email. - The form's honeypot field is left empty in sample data, as filling it drops a real submission.
1.3.3
November 12th, 2026
Fixed
- A listener without an API check no longer counts as a check that passed. Canary found it
by reading its code but ran nothing against it, yet the summary said "integration check
passed". On a site whose forms have no emails and send only to an unchecked CRM, such as
ActiveCampaign listeners without
canaryCheck(), a run tested nothing and still exited 0. Those forms now count as tested nothing, so such a run fails, and the summary counts the listeners as "without an API check".
1.3.2
November 3rd, 2026
Fixed
- Mailers from transport packages, such as MailerSend, pass the mailer check. Canary checked
each mailer on a new mail manager, which doesn't have the transports packages register, so
every site sending through one failed with
Unsupported mail transport.
1.3.1
November 2nd, 2026
Changed
- The real
ccandbccare checked and listed. Canary removes them from test emails, but the real email still goes to them, so an invalid one fails the run and-vand--dry-runshow them alongside thetoaddress. --scanpicks out failed form emails from other failed jobs, with the date each failed, as each is an enquiry that never arrived. Other failed jobs, such as cache warming, are only counted.
1.3.0
November 2nd, 2026
Added
canaryChecks()for a listener that sends to several services. Each service gets its own read-only check, is listed by name and passes or fails on its own. A check that returns a string passes with it as a warning, such as "disabled in Globals".--scanlists every form listener, anything that could email someone other than the test address (a customsend_email_job, aMessageSendinglistener or a globalmail.to), each form's emails and the failed jobs waiting. It tests nothing and always exits 0.- Each email's mailer is created before anything is sent, so a missing transport package or
a mistyped
MAIL_MAILERfails the run,--dry-runincluded, instead of failing later in the queue worker. Creating a mailer sends nothing. - More of a listener's code is read: a variable assigned from the handle,
Str::startsWith()andstr_starts_with()prefixes matched against the site's forms,matchandswitcharms, and an earlyreturnthat leaves a form out. Every service the code names is found, not just the first.
Changed
--subscribeis refused for a listener that sends to more than one service, by its checks or its code. It runs the whole listener, so the test contact would reach every service and could only be deleted from one.- A form an
elsebranch ordefaultarm may reach isn't reported as having nothing to test. - Unregistered listeners in
app/Listenersare only listed if they're for forms.
1.2.0
November 2nd, 2026
Added
- Emails built in code. A listener that sets a form's emails when it's submitted can tell
Canary about them with
canaryEmails(). They replace the form's own settings, as on a real submission, and go to the test address like any other form email. A listener that only builds emails isn't listed as an integration. - Each email is checked before it's sent. Its template must render, and its real recipients,
read before the test address replaces them, must be valid email addresses. A placeholder
address such as
hello@example.comgets a warning.-vlists the real recipients. --dry-runbuilds and checks every email and runs the API checks, but sends nothing. It reports where each email would have gone instead, and says the mailer and queue weren't tested.--nowsends the emails during the run instead of through the queue, so a mailer error fails it.- A summary at the end of every run, and a reminder to check
queue:failedwhen the emails went through a real queue. - Checks and
canaryEmails()can only read. Canary blocks any request through Laravel's HTTP client that isn't a GET or HEAD while they run, such as a token refresh, and fails the check even if the listener catches the error.
Changed
- A run that tests nothing at all now exits non-zero. It used to warn and exit 0, which looked like a pass. A form with nothing to test alongside others still only warns.
- A form isn't reported as having nothing to test when a listener might handle it. The list
names a listener that builds emails without
canaryEmails(), or one whose forms Canary can't tell. - Emails that only differ by recipient are sent once, saying how many they cover.
- Checkboxes and multi-selects get every option in test emails, so routing rules all fire.
Data sent to a real service with
--subscribestill gets one. - Validators, such as a reCAPTCHA listener, aren't warned about, and a listener whose
canaryForms()returns[]is left alone.
1.1.1
November 2nd, 2026
Fixed
--subscribeno longer leaves a contact behind when the listener uses a job. Jobs the listener dispatches now run straight away, so the contact exists before Canary checks for it and deletes it. If a job forces a real queue connection anyway, Canary fails and says to delete the test address by hand once a worker has run it.
1.1.0
October 30th, 2026
Added
- Integration checks. A form listener, such as one that adds people to MailerLite or
ActiveCampaign, can tell Canary which forms and fields it handles through plain methods
(
canaryForms(),canaryName(),canaryCheck()), with no dependency on Canary.canary:formsthen checks each one is registered, the form still has the fields it reads, and a read-only API call succeeds. Listeners inapp/Listenersthat have the methods but aren't registered are reported. - Listeners without the methods are found from their code. Canary recognises the usual
ways a listener picks its forms (comparing the handle,
in_array(), a handle-keyed array, or a handle from config) and finds the fields it reads and the service it names. Those forms are checked for registration and fields, and listed as(no API check). A listener from a package is named after its addon or package instead. Every run warns about form listeners whose forms still can't be found. --subscriberuns each integration's listener alone with a test submission, checks the contact arrived, then deletes it. It needscanaryContact()andcanaryDelete(), and refuses to run if the test address is already a contact.- Every run names the queue connection and queue the emails go on, such as
the default queue of the redis connection, so you know which worker has to run them. - Every run names the mailer, and warns when it's
logorarray. Forsmtpit adds the host and port, so a local mail catcher is obvious. A form email with its ownmailernames it when it's dispatched.
Changed
- The form picker says what each form tests, such as
contact - notification emailornewsletter - auto-reply email, MailerLite. Forms with nothing to test showno emails or integrations foundand are still listed last. - A form with integrations but no emails is tested, instead of warning that there's nothing to test.
1.0.0
October 23rd, 2026
Initial release.
Added
canary:formschecks a form's emails still send, without a real submission. It sends each of the form's real emails (template, subject, from address and mailer) to one test address through the site's queue, withTEST:before the subject andccandbccremoved. No submission is saved,FormSubmittedandSubmissionCreatedaren't fired, so newsletter and CRM integrations never see it, and the form itself is never changed. It exits non-zero if a form is missing or its emails fail to dispatch, so a deploy script can stop.- A list of the site's forms to pick from. Run with no handles and Canary lists every form,
with the ones that send no emails at the bottom. After picking, it offers to save the choice,
and later runs, deploy scripts included, test the saved forms without asking.
--pickshows the list again. - Config for the test address and default forms.
CANARY_TOsets the address, andcanary.formsinconfig/canary.phplists forms to test when none are passed. --sitesends as a given site on a multisite.