--- title: Conditional Payment Methods Settings Reference description: Every Conditional Payment Methods setting with its label, option ID, default and Free/Pro status. url: "https://wpfactory.com/docs/conditional-payments-settings-reference/" updated: "2026-09-27" category: References --- # Conditional Payment Methods Settings Reference This reference lists every setting in [Conditional Payment Methods for WooCommerce](https://wpfactory.com/item/conditional-payment-gateways-for-woocommerce/), with its label, option ID, default and Free/Pro status. All settings live at **WPFactory > Conditional Payment Gateways** (also reachable at **WooCommerce > Settings > Conditional Payment Gateways**), split into a General section and one section per condition. ## General section | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Conditional Payment Gateways: Enable plugin | `alg_wc_cpg_plugin_enabled` | Yes | Free | | Debug: Enable (writes a log to WooCommerce > Status > Logs) | `alg_wc_cpg_debug_enabled` | No | Free | | Leave at least one gateway: Enable (never hides the last remaining gateway) | `alg_wc_cpg_leave_at_least_one_gateway` | No | Free | | Notice styling (Notice, Error or Success) | `alg_wc_cpg_notice_type` | Notice | Free | | Available Conditions: Conditions (one checkbox per Require, Exclude, Minimum or Maximum rule) | `alg_wc_cpg_{condition}_{rule}_enabled` | No | Free | ## Settings in every condition section Each condition has two rule blocks (Require and Exclude, or Minimum and Maximum for Cart Total). Every block contains the settings below. `{condition}` and `{rule}` are the IDs from the next table. | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | | Enable/disable: Enable section (same setting as the checkbox on the General section) | `alg_wc_cpg_{condition}_{rule}_enabled` | No | Free | | One field per payment gateway, labeled with the gateway title (the tooltip shows the gateway key) | `alg_wc_cpg_{condition}_{rule}[{gateway_key}]` | Empty (no restriction) | Free for `bacs`, `cheque`, `cod` and `paypal`; Pro for all other gateways (read-only or disabled in the free version) | | Additional notice: Enable | `alg_wc_cpg_{condition}_{rule}_notice_enabled` | Yes | Free | | Notice text (HTML and shortcodes allowed) | `alg_wc_cpg_{condition}_{rule}_notice` | Condition-specific message | Free | | Reset section settings: Reset | `alg_wc_cpg_{section}_reset` | No | Free | ## Conditions and their IDs | Section | Condition ID | Rules | Field type | Notice placeholders | | --- | --- | --- | --- | --- | | Date/Time | `date_time` | `incl`, `excl` | Text area, one `from-to` range per line | `%gateway_title%` | | Customer IP | `ip` | `incl`, `excl` | Text area, one IP or CIDR range per line | `%gateway_title%` | | User | `user` | `incl`, `excl` | Text area, one user ID per line (`0` = guests) | `%gateway_title%` | | User Role | `user_role` | `incl`, `excl` | Multiselect of roles | `%gateway_title%` | | Cart Total | `cart_total` | `min`, `max` | Text, amount (`0` = ignored) | `%gateway_title%`, `%value%`, `%result%` | | Currency | `currency` | `incl`, `excl` | Multiselect of currencies | `%gateway_title%` | | Country | `country` | `incl`, `excl` | Multiselect of countries | `%gateway_title%` | | Product | `product` | `incl`, `excl` | Product and variation search | `%gateway_title%` | | Product Category | `product_cat` | `incl`, `excl` | Multiselect of categories | `%gateway_title%` | | Product Tag | `product_tag` | `incl`, `excl` | Multiselect of tags | `%gateway_title%` | | Product Shipping Class | `product_shipping_class` | `incl`, `excl` | Multiselect of shipping classes | `%gateway_title%` | | Product Taxonomy | `product_taxonomy` | `incl`, `excl` | Multiselect of terms | `%gateway_title%` | | Product Title | `product_title` | `incl`, `excl` | Text area, one string per line | `%gateway_title%` | | Language | `language` | `incl`, `excl` | Multiselect of WPML or Polylang languages | `%gateway_title%` | In the admin, `incl` is labeled **Require**, `excl` **Exclude**, `min` **Minimum** and `max` **Maximum**. For example, the option that turns on Exclude Country is `alg_wc_cpg_country_excl_enabled`. ## Extra settings in some sections | Section | Label | Option ID | Default | Free/Pro | | --- | --- | --- | --- | --- | | Cart Total | Cart Total Calculation: Cart total | `alg_wc_cpg_cart_total_calc` | `[alg_wc_cpg_cart_total exclude_taxes="yes" exclude_shipping="no" exclude_discounts="no"]` | Free | | Country | Country Detection: Country detection (Country by IP (geolocation), Billing country, Shipping country) | `alg_wc_cpg_country_source` | Country by IP (geolocation) | Free | | Product Taxonomy | Settings: Taxonomy slug | `alg_wc_cpg_product_taxonomy_slug` | Empty | Free | | Product Title | Settings: Product data (Product title, Product description, Product short description) | `alg_wc_cpg_product_title_source` | Product title | Free | | Product Title | Settings: Comparison function (Case-sensitive, Case-insensitive) | `alg_wc_cpg_product_title_func` | Case-sensitive | Free | ## Related articles - [Getting started with Conditional Payment Methods](https://wpfactory.com/docs/conditional-payments-getting-started/) - [Free vs Pro](https://wpfactory.com/docs/conditional-payments-free-vs-pro/) - [Shortcodes and developer reference](https://wpfactory.com/docs/conditional-payments-developer-reference/) ### Ready to set this up? Every setting above is included in the free version for the four built-in WooCommerce gateways. [Get Conditional Payment Methods Pro](https://wpfactory.com/item/conditional-payment-gateways-for-woocommerce/) to use them with any payment gateway. Need a hand? Our team answers every ticket on the [Conditional Payment Methods support forum](https://wpfactory.com/support/item/conditional-payment-gateways-for-woocommerce/). Related articles - [Troubleshooting Conditional Payment Methods](https://wpfactory.com/docs/conditional-payments-troubleshooting/) - [How to Restrict Payment Methods by Currency or Language in WooCommerce](https://wpfactory.com/docs/conditional-payments-currency-language/) - [How to Enable Payment Methods by Date and Time in WooCommerce](https://wpfactory.com/docs/conditional-payments-date-time/) - [How to Hide Payment Methods by Product, Category or Tag in WooCommerce](https://wpfactory.com/docs/conditional-payments-by-product/) - [How to Restrict Payment Methods by User Role, User or IP Address in WooCommerce](https://wpfactory.com/docs/conditional-payments-user-role/)