Black Friday All Access $999 $399 lifetime or 30% off any plugin with Ends in -- See deals
View Categories

Order Status Rule Conditions Reference

Each rule in Scheduled & Automatic Order Status Controller for WooCommerce can be limited by conditions, so it only changes orders that match. This reference lists every condition, its option ID and default. A condition is ignored when left empty, and a rule applies only when all of its non-empty conditions match. Every condition here is available in the free version for your single rule.

Conditions live inside each Rule section at WPFactory > Order Status Rules (also reachable at WooCommerce > Settings > Order Status Rules). In the option IDs below, [1] is the rule number.

Timing #

Label Option ID Default
Time trigger alg_wc_order_status_rules_time_trigger[1] 1
Time trigger unit alg_wc_order_status_rules_time_trigger_unit[1] hour(s)
Skip days alg_wc_order_status_rules_skip_days[1] (none)
Skip dates alg_wc_order_status_rules_skip_dates[1] (empty)

Order amounts and quantity #

Label Option ID Default
Minimum amount alg_wc_order_status_rules_min_amount[1] (empty)
Minimum amount type alg_wc_order_status_rules_min_amount_type[1] Order subtotal
Maximum amount alg_wc_order_status_rules_max_amount[1] (empty)
Maximum amount type alg_wc_order_status_rules_max_amount_type[1] Order subtotal
Minimum quantity alg_wc_order_status_rules_min_qty[1] (empty)
Maximum quantity alg_wc_order_status_rules_max_qty[1] (empty)

Amount type can be Order subtotal or Order total. Quantity is the number of items in the order.

Payment and shipping #

Label Option ID Default
Payment gateways alg_wc_order_status_rules_gateways[1] (none)
Shipping methods alg_wc_order_status_rules_shipping_instances[1] (none)
Local pickup location name alg_wc_order_status_rules_pickup_location_name[1] (empty)

Countries #

Label Option ID Default
Billing countries alg_wc_order_status_rules_billing_countries[1] (none)
Shipping countries alg_wc_order_status_rules_shipping_countries[1] (none)

Products, categories, tags and stock status #

Label Option ID Action option ID
Products alg_wc_order_status_rules_products[1] alg_wc_order_status_rules_products_require_all[1]
Product categories alg_wc_order_status_rules_product_cats[1] alg_wc_order_status_rules_product_cats_require_all[1]
Product tags alg_wc_order_status_rules_product_tags[1] alg_wc_order_status_rules_product_tags_require_all[1]
Product stock status alg_wc_order_status_rules_product_stock_status[1] alg_wc_order_status_rules_product_stock_status_require_all[1]

Each of these four conditions has an action selector (default Require) with four values:

  • Require: at least one item in the order matches the selection.
  • Require all: every item in the order matches the selection.
  • Exclude: the rule applies only when no item matches the selection.
  • Exclude all: the rule applies unless every item matches the selection.

Developer note: the stored option key for the action is ..._require_all even though it now offers exclude values too. Use the exact key shown above when reading or writing it in code.

Coupons #

Label Option ID Default
Coupons alg_wc_order_status_rules_coupons[1] Do not check
Specific coupons alg_wc_order_status_rules_specific_coupons[1] (empty)

Coupons can be Do not check, Any coupon, Specific coupon(s) or No coupons. Specific coupons is a comma-separated list, used only when Specific coupon(s) is selected.

Users #

Label Option ID Default
Billing emails alg_wc_order_status_rules_billing_emails[1] (empty)
User roles alg_wc_order_status_rules_user_roles[1] (none)
Users alg_wc_order_status_rules_users[1] (none)
Paying customer alg_wc_order_status_rules_paying_customer[1] Do not check

Billing emails accepts a comma-separated list. Paying customer can be Do not check, Paying customer or Not paying customer.

Dates and order meta #

Label Option ID Default
Date created before alg_wc_order_status_rules_date_created_before[1] (empty)
Date created after alg_wc_order_status_rules_date_created_after[1] (empty)
Meta key alg_wc_order_status_rules_meta_key[1] (empty)
Meta value alg_wc_order_status_rules_meta_value[1] (empty)
Multiple meta values alg_wc_order_status_rules_meta_value_is_multiple[1] No
Meta compare alg_wc_order_status_rules_meta_compare[1] Equals

Dates are compared in UTC. Meta compare can be Equals or Not equals; enable Multiple meta values to match any value in a comma-separated list.

Hide conditions you do not use #

To simplify the rule screen, use Disabled conditions in the Advanced section to remove condition groups you never need.

Put these conditions to work #

Every condition above is free for your single rule. To apply different condition sets across several rules at once, Order Status Rules Pro removes the single-rule limit. See what Pro unlocks.

wpf Order status rules for woocommerce Icon

Order Status Rules

Get more from Order Status Rules

See every feature and the pricing on the Order Status Rules plugin page.