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

Create, edit, and delete rules

A firewall rule has two main attributes: an expression and an action.

When an incoming HTTP request matches a firewall rule expression, Cloudflare performs the specified action. For more information, refer to Expressions and Actions.

Create a firewall rule

  1. Log in to the Cloudflare dashboard, and select your account and website.

  2. Navigate to Security > WAF > Firewall rules.

  3. Click Create a firewall rule.

  4. In the Create firewall rule page that displays, use the Rule name input to supply a descriptive name.

  5. Under When incoming requests match, use the Field drop-down list to choose an HTTP property (refer to Fields reference for details). For each request, the value of the property you choose for Field is compared to the value you specify for Value.

    Alternatively, use the Expression Editor to define the rule expression.

    Example firewall rule expression with a selected field, operator, and value

  6. Use the Operator drop-down list to choose a comparison operator. For an expression to match, the value of the request Field and the value specified in the Value input must satisfy the comparison operator.

  7. Next, specify the value to match. If the value is an enumeration, then the Value control will be a drop-down list. Otherwise, it will be a text input.

  8. To add a new sub-expression to the rule expression, click And or Or next to the Value control.

  9. Select an action for your rule in the Action drop-down list.

  10. To save and deploy your rule, click Deploy. If you are not ready to deploy your rule, click Save as draft.

After you choose an option, you return to the rules list, which displays your new rule.

Manage rules

Use the available options in the rules list to manage firewall rules.

The rules list interface in the dashboard where you can manage firewall rules

Edit rule

Click Edit (wrench icon) located on the right of your rule in the rules list to open the Edit firewall rule panel and make the changes you want.

Enable or disable rule

Use the toggle switch associated with a firewall rule to enable or disable it.

Delete rule

To delete an existing rule from the Firewall rules panel, click Delete (X icon) next to the rule you want to remove.

In the confirmation dialog that appears, click Delete to confirm and complete the operation.

Order rules

By default, Cloudflare evaluates firewall rules in list order, where rules are evaluated in the order they appear in the rules list. When list ordering is enabled, the rules list allows you to drag and drop firewall rules into position, as shown below.

Animation of a user dragging and dropping a rule in the rules list to reorder it

Once there are more than 200 total rules (including inactive rules), you must manage evaluation using priority ordering, in which Cloudflare evaluates firewall rules in order of their priority number, starting with the lowest. When you cross this threshold, the firewall rules interface automatically switches to priority ordering. For more on working with priority ordering, refer to Order and priority.

Test firewall rules with Rule Preview

Rule Preview allows customers on an Enterprise plan to understand the potential impact of a new firewall rule, by testing it against a sample of requests drawn from the last 72 hours of traffic.

Rule Preview is built into the Create firewall rule and Edit firewall rule panels so that you can test a rule as you edit it. For more information, refer to Preview rules.