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.