Skip to content
Firewall
Visit Firewall on GitHub
Set theme to dark (⇧+D)

Rules Lists

Use Rules Lists to create a group of IP addresses and refer to them collectively, by name, in your firewall rule expressions.

For example, you might create a list of known office IP addresses and use it in a firewall rule that allows requests from the addresses on the list to bypass security features. Or you may want to block requests that don't come from the known office addresses.

When you update the content of a list, any rules that use the list are automatically updated, so you can make a single change to your Firewall Rules list rather than modify rules individually.

Cloudflare stores your lists at the account level and sends to the edge, so you can view, manage, and incorporate them into firewall rules for any of your zones.

Advantages of Lists

Using Rules Lists has these advantages:

  • When creating a firewall rule, using a Rules List is easier and less error-prone than adding a long list of IP addresses to a firewall rules expression.
  • When updating a set of firewall rules that target the same group of IP addresses, using a Rules List is easier and less error prone than editing multiple firewall rules.
  • Rules Lists are easier to read and more informative, particularly when you use descriptive names for your lists.

Entitlements

The number of Rules Lists you can create depends on the Cloudflare plans associated with the zones in your account. Regardless of plan, you can store up to a total of 1000 items, spread across all of your lists.

Cloudflare plan
FreeProBusinessEnterprise
Number of Rules Lists1101010

Managing lists

  • To manage and edit lists from your Cloudflare account interface, see Use Rules Lists.
  • To manage and edit lists using the Cloudflare API, see Rules Lists API.

Using lists in expressions

Both the Cloudflare dashboard and the Cloudflare API support Rules Lists.

To use Rules Lists in an expression from the Cloudflare dashboard, see Use lists in expressions.

To refer to a rules list in a Cloudflare Filters API expression, see Values: Rules Lists in the Firewall Rules language reference.