wc-emails-classic

Extends WooCommerce email classes with custom PHP templates and triggers via hooks.

21|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Lonsdale201/wp-agent-skills --skill wc-emails-classic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wc-emails-classic
Source: https://github.com/Lonsdale201/wp-agent-skills/tree/main/woocommerce/wc-emails-classic
Command: npx skills add https://github.com/Lonsdale201/wp-agent-skills --skill wc-emails-classic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WooCommerce's classic transactional emails rely on the PHP-template path and the WC_Email class. This skill guides developers to extend WC_Email, override templates, and tune subject/heading strings for custom notifications, without using the block editor.

Core Features & Use Cases

  • Extend WC_Email to create new, customer-facing or admin emails that WooCommerce can dispatch.
  • Override existing email templates by placing copies in the theme under woocommerce/emails, ensuring theme-level customization with safe fallbacks.
  • Register custom emails via the woocommerce_email_classes filter and align with WooCommerce status transitions using the _notification actions.
  • Manage locale consistency and admin-configurable strings to support multilingual sites and business-specific messaging.

Quick Start

Create a custom email by extending WC_Email, configure template_html/plain paths, register via the woocommerce_email_classes filter, and hook into a woocommerce_order_status_*_notification action.

Frequently Asked Questions about wc-emails-classic

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a custom transactional email in WooCommerce?▼

To add a custom WooCommerce email, extend the WC_Email class, configure template paths, register it via the woocommerce_email_classes filter, and bind it to a woocommerce_order_status_*_notification action.

How do I override WooCommerce email templates in my theme?▼

To override WooCommerce email templates in your theme, place copied template files under woocommerce/emails in your theme directory. This ensures theme-level customization for your transactional emails while maintaining safe fallbacks to default plugin templates.

How do I trigger custom WooCommerce emails on order status changes?▼

Trigger custom WooCommerce emails on order status changes by binding your WC_Email subclass to woocommerce_order_status_<from>_to_<to>_notification actions. This ensures your custom notification dispatches correctly during specific order status transitions.

Does this WooCommerce email customization approach use the block editor?▼

No, this WooCommerce email customization approach does not use the block editor. It specifically targets the classic PHP-template path, allowing developers to tune subject and heading strings via admin settings and subclass WC_Email directly.

How do I manage locale consistency for custom WooCommerce transactional emails?▼

Manage locale consistency for custom WooCommerce transactional emails by utilizing admin-configurable strings within your WC_Email subclass. This approach supports multilingual sites and ensures business-specific messaging across different locales.

What is the best way to adjust subject and heading strings for WooCommerce emails?▼

The best way to adjust subject and heading strings for WooCommerce emails is through admin settings configured within your extended WC_Email class. This allows business-specific messaging and locale consistency without modifying core plugin files.