WC Sale Discord Notifications

This plugin sends a Discord notification for WooCommerce order events. It uses native WordPress/WooCommerce APIs and supports WooCommerce Custom Order Tables (HPOS). You can choose which order statuses trigger notifications, customize which details are included, set different webhook URLs and embed colors per status, and optionally remove product images from the embed.

Features

• Customizable message fields:

  • Order Status
  • Payment Info
  • Product Lines (names, qty, price)
  • Product Options (add-ons / custom fields)
  • Order Date
  • Billing Info
  • Transaction ID
  • Order Notes (customer and/or internal)

• Initiating payment notification when a customer begins checkout (pending)

• Customer notes only toggle – exclude internal/admin notes when Order Notes is included
• Option to disable product image in the embed
• Per-status webhook URL and embed color
• Duplicate-send protection via order meta (120s deduplication for initiating, new, and update)
• Automatic embed size trimming for Discord’s 6000 character limit
• Built using native WordPress/WooCommerce APIs
• Compatible with WooCommerce Custom Order Tables (HPOS)
• Subscription-aware titles when WooCommerce Subscriptions is active (New subscription, Subscription Renewal)

Requirements

• WordPress 6.2 or higher (tested up to 6.9.4)
• WooCommerce 8.5 or higher (tested up to 10.6.1)
• PHP 8.0 or higher

Configuration

1. Webhook URL Enter your Discord Webhook URL (from your Discord server settings).

2. Order Status Notifications Choose which order statuses should trigger notifications. You can also:

   • Add different webhook URLs per status
   • Choose unique embed colors

3. Embed Fields Select which fields should appear in the Discord embed (status, payment info, items, custom product fields, order date, billing info, transaction ID, order notes).

4. Customer notes only When Order Notes is included, show only customer notes (exclude internal/admin notes).

5. Disable Product Image Toggle this to prevent the product image from appearing in the embed.

6. Send notification for Initiating payments When enabled, sends “Initiating payment” for pending orders, then “New Order!” when payment completes (processing).

Duplicate Protection

To prevent duplicate Discord messages (for example, if the thank-you page is refreshed), the plugin stores sent-event metadata on each order (_discord_sent_*). Initiating, new, and update notifications all use 120-second time-based deduplication. Before sending, the plugin checks whether that event was already sent within the last 120 seconds and skips if so. This ensures each notification is only sent once per order event.

Usage

1. After installing and activating the plugin, go to WooCommerce → Discord Notifications.
2. Paste your Discord Webhook URL and select which statuses should send notifications.
3. Choose which fields to include, whether to show product images, and whether to limit order notes to customer notes only.
4. Save your settings.

Author

Cral_Cactus

Support

Found a bug or have a suggestion? Open an issue on the GitHub repo: https://github.com/Cral-Cactus/wc-sale-discord-notifications/issues