Cloudflare Docs
Firewall Rules
Visit Firewall Rules on GitHub
Set theme to dark (⇧+D)

Manage IP List items

​​ View items in an IP List

  1. Access the Lists interface available at Manage Account > Configurations > Lists.

  2. Select Edit next to the list you want to view.

The list of items displays sorted by IP address, ascending:

List interface in the Cloudflare dashboard displaying the ordered list items of an IP List

​​ Add items to a list

IP Lists support:

  • Individual IPv4 addresses
  • IPv4 CIDR ranges with a prefix from /8 to /32
  • IPv6 CIDR ranges with a prefix from /4 to /64

You can combine individual addresses and CIDR ranges in the same list.

You can use uppercase or lowercase characters for IPv6 addresses in lists. However, when you save the list, uppercase characters are converted to lowercase.

To add items to an IP List:

  1. Access the Lists interface available at Manage Account > Configurations > Lists.

  2. Select Edit next to the list you want to edit.

  3. Select Add items.

  4. To add items to the list manually, use the text inputs in the Lists interface.

  5. To add items in CSV format, select Upload CSV.

​​ Add items to a list manually

  1. In the Add items to list page, add an IP address and an optional description in the text inputs.

    As you enter information into a text input, a new row of inputs displays below the current one. To delete any of the IP addresses that you have entered, select X.

  2. Select Add to list.

​​ Add items in CSV format

​​ Use valid CSV file format

When uploading a CSV file containing a list of IP addresses and optional descriptions, be sure that each item is on its own line, as in this example:

<IP_ADDRESS_1>,<DESCRIPTION_1>
<IP_ADDRESS_2>

​​ Upload a CSV file

To add items to an IP List by uploading a CSV file:

  1. In the Add items to list page, select Upload CSV.

  2. Browse to the location of the CSV file, select the file, and then select Open. The displayed items in the page will include the items loaded from the CSV file.

  3. You can continue to edit the items in the list before adding them:

    • To delete any of the IP addresses that you have entered, select X.
    • To add extra IP addresses manually, enter the information in the text inputs.
  4. Select Add to list.

​​ Delete items from a list

  1. Access the Lists interface available at Manage Account > Configurations > Lists.

  2. Select Edit next to the list from which you want to delete items.

  3. Select the checkboxes next to the items you want to delete. To select all the items, use the checkbox in the column header:

    Selecting individual list items to delete from an IP List

  4. Select Remove.

  5. In the confirmation dialog, select Remove to complete the operation.