The WooCommerce stock status trigger can start a workflow when a product’s stock status changes. Use it for notifications or follow-up actions when an item moves between stock states. The trigger responds to status transitions, not every change in stock quantity.
Screenshot to add: Workflow editor showing Product Stock Status Updated and Product Status Changed trigger options
Available product status triggers
- Product Stock Status Updated: runs when the product stock status changes. Supported stock status values include
instock,outofstock, andonbackorder. - Product Status Updated: runs when the WooCommerce product post status changes, such as to publish, draft, or pending.
- Product Status Changed: combines product post-status and stock-status transitions into one trigger.
Configure a stock status trigger
- Confirm that WooCommerce is active.
- Open Agent Workflows and edit the workflow.
- Add Product Stock Status Updated if you only need stock-status transitions, or choose Product Status Changed if the workflow should also react to product post-status transitions.
- Connect the trigger to a notification or other action and map the product data it needs.
- Save and test with a staging product or another controlled stock-status change. Review the old and new status values before activating the workflow.
Inspect the product payload
The payload includes source (woocommerce), event, and product_id. When the product object is available, it can also include the product name, SKU, product status, stock status, stock quantity, and stock-management settings. A stock transition includes old_stock_status and new_stock_status; the implementation also provides old_status and new_status.
Stock status is not stock quantity
A quantity update that leaves the stock status unchanged is not the same as a stock-status transition. Use this trigger for state changes such as in stock, out of stock, or on backorder. Test your store’s stock-management settings before relying on a workflow for inventory alerts.