Email Notifications

Quantum Competitions integrates natively with the WooCommerce email engine. All transactional emails are managed through WooCommerce > Settings > Emails and use your active WooCommerce email styling, header, footer, and recipient settings.

Registered Transactional Emails

The plugin registers 8 dedicated transactional emails covering every event in the competition lifecycle:

Email ID	Title	Recipient	Trigger Event
`competition_win`	Competition Won	Customer (Winner)	Sent immediately when the winner is drawn (manual or automated).
`competition_failed`	Competition Failed (Admin)	Store Admin	Sent when a competition ends without meeting the minimum ticket threshold.
`competition_failed_users`	Competition Failed (Customer)	Participants	Notifies all entrants that the competition failed and explains the refund/cancellation status.
`competition_finished`	Competition Finished (Admin)	Store Admin	Sent when a competition successfully finishes and all tickets or end dates are completed.
`competition_no_luck`	Competition No Luck	Non-Winning Entrants	Polite notification sent to participants who did not win the draw.
`competition_extended`	Competition Extended	Participants	Sent when a competition fails to meet minimum tickets and is automatically extended.
`competition_instant_win`	Instant Win (Customer)	Customer (Winner)	Sent immediately after checkout when a customer picks or is allocated an instant win ticket.
`competition_instant_win_admin`	Instant Win (Admin)	Store Admin	Alerts store management immediately when an instant win prize has been claimed.

Configuring Email Settings

To configure each email template:

In WP Admin, navigate to WooCommerce > Settings > Emails.
Scroll to the competition emails (prefixed with Competition or Instant Win).
Click Manage on the right side of any email.

Configurable Options

Enable/Disable: Toggle whether this specific email should be sent.
Subject: The email subject line. Supports dynamic placeholders (e.g. {site_title}, {competition_title}).
Email Heading: The large heading at the top of the email body.
Email Type: Choose between HTML, Plain text, or Multipart.

Template Customization & Overrides

Each email template can be safely overridden in your child theme to match your bespoke branding without losing modifications during plugin updates.

Template File Locations

Plugin core templates are located in:

wp-content/plugins/quantum-competitions-for-woocommerce/templates/emails/

Core Template	Plain Text Template	Description
`competition-win.php`	`plain/competition-win.php`	Winner announcement email
`competition-failed.php`	`plain/competition-failed.php`	Admin notification for failed competition
`competition-failed-users.php`	`plain/competition-failed-users.php`	Customer notification for failed competition
`competition-finished.php`	`plain/competition-finished.php`	Admin notification for finished competition
`competition-no-luck.php`	`plain/competition-no-luck.php`	Entrant consolation email
`competition-extended.php`	`plain/competition-extended.php`	Competition extension notice
`competition-instant-win.php`	`plain/competition-instant-win.php`	Customer instant win confirmation
`competition-instant-win-admin.php`	`plain/competition-instant-win-admin.php`	Admin instant win alert

How to Override in Your Theme

Copy the desired template file from the plugin directory to:

wp-content/themes/your-child-theme/woocommerce/emails/[template-name].php

Alternatively, go to WooCommerce > Settings > Emails > [Select Email] and click the Copy file to theme button at the bottom of the settings screen.

Email Hooks & Custom Data

Developers can inject custom meta, coupon codes, or banners into competition emails using action and filter hooks:

/**
 * Add custom sponsor banner before competition win email content.
 *
 * @param WC_Product_Competition $product The competition product object.
 * @param WC_Order               $order   The winning order object.
 */
add_action( 'qcw_email_before_competition_win', function( $product, $order ) {
    echo '<p style="text-align:center;"><img src="https://example.com/sponsor-banner.jpg" alt="Sponsor" /></p>';
}, 10, 2 );