Cloudflare Docs
Firewall
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. To view items in a list, click the Edit link associated with 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. Click the Edit button associated with the list that you want to edit.

  3. Click 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 , click 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, click X.

  2. Click Add to list to add the new items.

The updated list displays.

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, click Upload CSV.

  2. Browse to the location of the CSV file, select it, and click 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, click X.
    • To add extra IP addresses manually, enter the information in the text inputs.
  4. Click Add to list to add the new items to your list.

Delete items from a list

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

  2. Click the Edit link associated with list from which you want to delete.

  3. Select the checkboxes next to the items that 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. Click Remove to delete the selected items from the list.

  5. Click Remove in the confirmation dialog.