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)

  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

  Read the full description on the official page →