Better Coupon Restrictions

How can we help?

Search the documentation or ask the AI agent anything about the plugin.

Restrict a coupon by IP address (PRO)

Updated September 15, 2026

The IP Address section (PRO) allows or blocks a coupon for particular IP addresses and can cap how many orders from one IP address use the coupon. It is in the Better Coupon Restrictions tab on the coupon edit screen.

The fields

  • Allowed IP Addresses: one per line. The coupon only works for visitors with one of these addresses.
  • Disallowed IP Addresses: one per line. Visitors with these addresses cannot use the coupon.
  • Maximum Usage Per IP Address: the maximum number of orders from the same IP address that can use this coupon. Cancelled, failed and refunded orders are not counted.

Entries must match the whole address exactly. Ranges, wildcards and CIDR notation such as 192.168.0.0/24 are not supported.

Messages: “Sorry, you can not use this coupon.” for the allow and block lists, and “This coupon has reached its usage limit.” for the per IP limit.

Global IP lists

Allowed IPs and Disallowed IPs can also be set for all coupons at WooCommerce › Settings › Better Coupon Restrictions. The global lists are combined with each coupon’s own lists. See Apply restrictions to all coupons with global settings (PRO).

Use with care

IP addresses are not a reliable way to identify a person. Many customers on one mobile network or office connection can share an address, and one customer’s address can change. A low Maximum Usage Per IP Address can block unrelated shoppers.

Proxies and CDNs

The visitor’s address is read using WooCommerce’s geolocation helper. If your site sits behind a reverse proxy or CDN and the server is not passing on the real visitor address, every visitor can appear to have the same IP. When this happens the coupon screen shows a note that your IP address is the same as the server IP address. Ask your host to configure the forwarded IP header.

Related

Was this article helpful?