WooCommerce template error
WooCommerce email disabled.
A disabled WooCommerce email stops before wp_mail(), SMTP, SPF, DKIM, DMARC, and recipient inbox filtering. Fix the template stage first.
Failure stage
Order event: WooCommerce can create or update the order.
Failed first: selected email template is disabled or lacks a valid recipient.
Not reached:
wp_mail(), SMTP provider, and recipient inbox delivery.Evidence-to-cause matrix
| Evidence | Likely cause | First check |
|---|---|---|
| Email toggle is off | Template disabled | Enable the exact email template. |
| Recipient field is empty for admin email | No recipient resolved | Add a valid admin recipient. |
| Only one email type fails | Template-specific setting | Do not change global SMTP first. |
| No provider log exists | Message never reached transport | Fix template before SMTP/DNS. |
| Custom code unhooks email class | Theme/plugin override | Check snippets and custom WooCommerce hooks. |
| Email template file overridden | Theme override risk | Check WooCommerce template status for outdated overrides. |
WooCommerce path
| Stage | What to verify |
|---|---|
| Order event | The order event may occur normally. |
| Email template | This is the failed stage: the selected template is disabled or has no recipient. |
| Recipient | Recipient is not resolved if the template or admin recipient is disabled. |
| wp_mail | Not reached until the template is enabled. |
| SMTP | Not reached; changing SMTP does not fix a disabled template. |
| Inbox | Not relevant until a provider log exists. |
Do this first / do not do this yet
Do this first
- Open the exact WooCommerce email template that failed.
- Turn on Enable this email notification.
- Check recipient fields for admin emails.
- Resend from order actions and watch provider logs.
Do not do this yet
- Do not rotate SMTP passwords.
- Do not rewrite SPF/DKIM/DMARC.
- Do not change MX records.
- Do not install another SMTP plugin to solve a disabled template.
Bad/current pattern
Email type: Customer completed order
Enabled: disabled
SMTP test: passes
Action taken: changed SMTP plugin
Result: no customer completed order emailCorrected pattern
Email type: Customer completed order
Enabled: enabled
Order status: completed
Action: resend completed order email
Provider log: message created for customer recipient