---
title: Payment Methods by Location Settings Reference
description: Every Payment Methods by Location setting with its label, option ID, default and Free/Pro status.
url: "https://wpfactory.com/docs/payments-by-location-settings-reference/"
updated: "2026-09-27"
category: References
---

# Payment Methods by Location Settings Reference

This reference lists every setting in [Conditional Payment Methods by Location for WooCommerce](https://wpfactory.com/item/payment-gateways-by-customer-location-for-woocommerce/), with its label, option ID, default and Free/Pro status. Settings are at **WPFactory > Payment Gateways by Customer Location** (also reachable at **WooCommerce > Settings > Payment Gateways by Customer Location**) in five sections.

## General section

| Label | Option ID | Default | Free/Pro |
| --- | --- | --- | --- |
| Detect country by (Billing country, Shipping country, Country by IP) | `alg_wc_gateways_by_location_country_type` | Billing country | Free |
| Detect state by (Billing state, Shipping state) | `alg_wc_gateways_by_location_state_type` | Billing state | Free |
| Detect city by (Billing city, Shipping city) | `alg_wc_gateways_by_location_cities_type` | Billing city | Free |
| Detect postcode by (Billing postcode, Shipping postcode) | `alg_wc_gateways_by_location_postcodes_type` | Billing postcode | Free |
| Advanced Options: Force JavaScript checkout update (Billing/Shipping state, city, postcode) | `alg_wc_gateways_by_location_force_js_checkout_update` | None selected | Free |

## Location sections

Each location section has an on/off switch plus an Include and an Exclude field for every payment gateway, listed by the gateway's admin name. Per-gateway values are stored in one option per field, keyed by gateway ID, for example `alg_wc_gateways_by_location_country_include[cod]`.

| Section | Label | Option ID | Default | Free/Pro |
| --- | --- | --- | --- | --- |
| Countries | Gateways by country: Enable section | `alg_wc_gateways_by_location_country_section_enabled` | Yes | Free |
| Countries | Include countries / Exclude countries (multiselect, includes European Union and Netherlands Antilles) | `alg_wc_gateways_by_location_country_include`, `alg_wc_gateways_by_location_country_exclude` | Empty | Free |
| States | Gateways by state: Enable section | `alg_wc_gateways_by_location_state_section_enabled` | Yes | Free |
| States | Include states / Exclude states (multiselect, base country states only) | `alg_wc_gateways_by_location_state_include`, `alg_wc_gateways_by_location_state_exclude` | Empty | Free |
| Cities | Gateways by city: Enable section | `alg_wc_gateways_by_location_city_section_enabled` | Yes | Free |
| Cities | Include cities / Exclude cities (text area, one city per line) | `alg_wc_gateways_by_location_city_include`, `alg_wc_gateways_by_location_city_exclude` | Empty | Free |
| Postcodes | Gateways by postcode: Enable section | `alg_wc_gateways_by_location_postcode_section_enabled` | Yes | Free |
| Postcodes | Include postcodes / Exclude postcodes (text area, one per line, wildcards and numeric ranges) | `alg_wc_gateways_by_location_postcode_include`, `alg_wc_gateways_by_location_postcode_exclude` | Empty | Free |
| Every section | Reset Settings: Reset section settings | `alg_wc_gateways_by_location_{section}_reset` | No | Free |

An empty Include or Exclude field is ignored. Turning a section off with **Enable section** skips that location type entirely, even if values are saved.

## Free and Pro

In version 1.8.0 the free and Pro builds contain the same settings, and the free version works with any payment gateway. Every setting above is available in both.

## Related articles

- [Getting started with Payment Methods by Location](https://wpfactory.com/docs/payments-by-location-getting-started/)
- [Developer hooks](https://wpfactory.com/docs/payments-by-location-developer-hooks/)

Need a hand? Our team answers every ticket on the [Payment Methods by Location support forum](https://wpfactory.com/support/item/payment-gateways-by-customer-location-for-woocommerce/).

Related articles

- [Troubleshooting Payment Methods by Location](https://wpfactory.com/docs/payments-by-location-troubleshooting/)
- [How to Restrict Payment Methods by Postcode or ZIP Code in WooCommerce](https://wpfactory.com/docs/payments-by-location-postcode/)
- [How to Restrict Payment Methods by City in WooCommerce](https://wpfactory.com/docs/payments-by-location-city/)
- [How to Restrict Payment Methods by State in WooCommerce](https://wpfactory.com/docs/payments-by-location-state/)
- [How to Show or Hide Payment Methods by Customer Country in WooCommerce](https://wpfactory.com/docs/payments-by-location-country/)