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
  • New or returning customer
  • Shipping method (freight)
  • 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)
• Optional shipping method field (chosen freight and price) in the embed
• Drag-and-drop Embed field order – arrange Discord embed fields (including Order ID) in any order
• Optional New or returning customer field (matches prior orders by customer ID or billing email)

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, new/returning customer, shipping method, transaction ID, order notes).

4. Embed field order
   Drag rows to set the order fields appear in Discord. Disabled Embed Fields are still skipped when sending.

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

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

7. 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, drag to set embed field order, 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