View Categories

Order Status Rule Conditions Reference

0:00 4:02
Table of Contents

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.