Order Alerts has two ways of telling somebody about an order, and three rules that keep them safe.
Rule 1: a recipient is added, never substituted
WooCommerce's New order email goes to the address under WooCommerce → Settings → Emails → New order → Recipient(s) — usually yours. The plugin hooks WooCommerce's woocommerce_email_recipient_new_order filter and appends its addresses to that list.
It never returns a list of its own. A plugin that did would be a shop whose owner quietly stops receiving their own orders — something nobody notices for a week, then notices all at once.
Addresses are merged case-insensitively. A rule naming your own admin address does not send you a second copy, and a supplier named by two rules is one recipient.
This is everything the free edition does: for every order, the people in your (up to three) rules are added to WooCommerce's new-order email. It sends no email of its own, so nothing can be sent twice.
Rule 2: a partial recipient gets a partial email — Full edition
WooCommerce's new-order email carries every line on the order, the customer's billing and shipping address, their phone number and the order total. A drop-shipper who supplies one line out of six has no business reading the other five, or what the customer paid.
So in the full edition a rule about some products, categories or shipping classes is set to Only their own lines by default. Such a rule never joins WooCommerce's email. Instead its people get their own plain-text message:
Subject: Order #1042 — items to pick (Your Store)
A new order needs these items. They are the only items on this order that are
yours to send.
2 × Frozen peas 1kg (FZ-PEAS-1)
1 × Ice cream tub (FZ-ICE-500)
Ship to:
Sarah Lewis
12 High Street
Leeds
LS1 1AA
- Only the lines the rule covers are listed, with quantity, name and SKU.
- The shipping address is added when Include the shipping address in a supplier's message is on (it falls back to the billing address when an order has no shipping address).
- The total, the payment method and the rest of the order are never included.
- A supplier named by two rules gets one message listing both sets of lines, and a line covered by two rules is listed once.
- A rule that matches nothing on the order sends nothing — an email with no lines would only make a supplier telephone to ask what it was.
A rule set to The whole order email instead behaves like the free edition: its people are added to WooCommerce's own email — but only when the order contains at least one line the rule covers. A rule about Every order is always a whole-order rule, because every line matched it.
What a rule covers
- These products: the product ids you list. Naming a variable product covers every variation; naming a variation covers only that size or colour.
- These categories: products in the categories you list or in any of their sub-categories.
- These shipping classes: products whose shipping class slug is in the list. A variation without its own class takes its parent's, as WooCommerce does.
Rule 3: one order sends one set of alerts — Full edition
A supplier's own message is sent when the order reaches the status chosen in Send them when an order reaches (Processing by default). WooCommerce fires that status hook more than once in ordinary use: put an order back to Processing and complete it again and the hook fires again.
So before anything is mailed the plugin writes a claim onto the order — order meta _gmal_sent, holding the time — and saves the order. An order that already carries the claim sends nothing. If you re-route an order and want it sent again, delete that custom field from the order.
A message cancelled through the gmal_order_alert filter still leaves the claim in place, so it is not retried on the next status change.
Low-stock alerts — Full edition
When WooCommerce reports that a product has reached its low-stock threshold (its woocommerce_low_stock action), the plugin looks for rules that:
- are in use, have recipients, and have Tell them about low stock too ticked, and
- cover the product — a variation is checked as itself and as its parent, because you route a product and WooCommerce warns about a size.
Each matching recipient receives "Running low: {product}" with the product name, SKU and stock left. The store-wide switch Also tell them when a product they cover is running low must be on. WooCommerce decides when a product is low — the threshold is the product's own Low stock threshold or your store-wide one under WooCommerce → Settings → Products → Inventory.
Worked example
A shop sells groceries and uses two suppliers and a warehouse:
| Rule | About | Which ones | Send them |
|---|---|---|---|
| Warehouse | Every order | — | The whole order email |
| Frozen supplier | These shipping classes | chilled-goods |
Only their own lines |
| Bakery | These categories | 57 |
Only their own lines |
An order arrives with two frozen items, a loaf from category 57 and a jar of honey.
- WooCommerce sends its New order email to you and the warehouse.
- When the order reaches Processing, the order is claimed, then:
- the frozen supplier receives the two frozen lines and the address;
- the bakery receives the loaf and the address;
- nobody but you and the warehouse hears about the honey or the total.
- You complete the order later. Nothing more is sent.
What is never touched
The plugin adds nothing to the storefront — no script, no stylesheet — and it creates no database tables. It never changes an order beyond writing the _gmal_sent claim (full edition).
