---
title: "Conditional Shipping: Developer Hooks and Filters Reference"
description: "Developer reference for Conditional Shipping for WooCommerce: filters, actions, option key prefixes and an AND/OR example."
url: "https://wpfactory.com/docs/woocommerce-conditional-shipping-hooks-filters/"
updated: "2026-09-26"
category: Developers
---

# Conditional Shipping: Developer Hooks and Filters Reference

## Developer Hooks and Filters Reference

[Conditional Shipping for WooCommerce: Restrict Shipping Options by Anything](https://wpfactory.com/item/conditional-shipping-for-woocommerce/) exposes a small set of WooCommerce conditional shipping hooks and filters so you can change how conditions are evaluated and how notices are rendered without editing the plugin files. This page lists every filter and action the plugin fires, with its arguments and what it controls.

All settings referenced below live under **WPFactory > Conditional Shipping** (also reachable at **WooCommerce > Settings > Conditional Shipping**).

### Filters

| Filter | Arguments | What it does |
| --- | --- | --- |
| `alg_wc_cond_shipping_logical_operator` | `$logical_operator, $rate, $package` | Changes the AND / OR logical operator at runtime, for example per rate. Return `'AND'` or `'OR'`. |
| `alg_wc_cond_shipping_method_id` | `$rate->method_id, $rate` | The method id used to look up a condition's stored value for a rate. Pro uses this to switch to per-instance ids. |
| `alg_wc_cond_shipping_settings_shipping_methods` | `$shipping_methods` | The list of shipping methods shown in the settings. Pro swaps in per-instance methods. |
| `alg_wc_cond_shipping_settings_method_id` | `$method_id, $method` | The method id used on the settings screen. |
| `alg_wc_cond_shipping_settings_method_title` | `$method_title, $method` | The method title shown on the settings screen. |
| `alg_wc_cond_shipping_settings` | varies | Internal Pro gate filter, returns `''` in Pro to unlock the "Use shipping instances" option. Not generally useful to site developers. |
| `alg_wc_conditional_shipping_notice_hooks` | array of hook names | Controls where the per-condition "Additional notice" is printed. Default `array( 'woocommerce_before_cart', 'woocommerce_before_checkout_form' )`. |

### Actions

| Action | Arguments | Fires when |
| --- | --- | --- |
| `alg_wc_cond_shipping_core_loaded` | `$core` | The core class is constructed. `$core` is the plugin core instance. |

### Option key prefixes

Most option keys use the prefix `wpjup_wc_cond_shipping_`. Two use `alg_wc_cond_shipping_` instead: the Logical operator option (`alg_wc_cond_shipping_logical_operator`) and the settings tab id (`alg_wc_cond_shipping`). This mismatch is real, so when you read options directly with `get_option()` you must use the exact key. For example the Debug option is `wpjup_wc_cond_shipping_debug`, but the operator is `alg_wc_cond_shipping_logical_operator`.

The plugin text domain is `conditional-shipping-for-woocommerce`, and the main instance function is `alg_wc_cond_shipping()`, which returns the plugin object.

### Example: switch AND / OR per rate

By default the plugin combines multiple enabled conditions with the global Logical operator option. Use `alg_wc_cond_shipping_logical_operator` to override it for a single rate, for example to make one method OR while the rest stay AND.

```
add_filter( 'alg_wc_cond_shipping_logical_operator', function ( $logical_operator, $rate, $package ) {
    if ( 'flat_rate:3' === $rate->id ) {
        return 'OR';
    }
    return $logical_operator;
}, 10, 3 );
```

### Example: change where the Additional notice prints

The per-condition "Additional notice" is printed on the cart and checkout pages using the hooks returned by `alg_wc_conditional_shipping_notice_hooks`. Return your own list of hook names to move it, for example to show it inside the cart totals as well.

```
add_filter( 'alg_wc_conditional_shipping_notice_hooks', function ( $hooks ) {
    $hooks[] = 'woocommerce_after_cart_table';
    return $hooks;
} );
```

Need a hand? Our team answers every ticket on the [Conditional Shipping support forum](https://wpfactory.com/support/).

Related articles

- [Reset a Conditional Shipping Settings Section](https://wpfactory.com/docs/reset-conditional-shipping-settings/)
- [Enable Debug Logging for Conditional Shipping](https://wpfactory.com/docs/conditional-shipping-debug-logging/)
- [Plugin and Theme Conflicts with Conditional Shipping](https://wpfactory.com/docs/plugin-theme-conflicts-conditional-shipping/)
- [Fix Conditional Shipping After Site Migration](https://wpfactory.com/docs/fix-conditional-shipping-after-site-migration/)
- [Getting Started with Conditional Shipping for WooCommerce](https://wpfactory.com/docs/how-to-use-conditional-shipping/)