---
name: cis-firewall-rule
title: Creating, editing, and deleting firewall rules
description: IBM Cloud&reg; Internet Services firewall rules offer power and flexibility by targeting HTTP traffic and applying custom criteria to block, challenge, log, or allow certain requests.
last-updated: 2026-08-05
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/cis?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Creating, editing, and deleting firewall rules
{: #about-firewall-rules}

Firewall rules are deprecated. CIS moved existing firewall rules to WAF custom rules. For more information on this change, see [Migrating to custom rules](https://cloud.ibm.com/docs/cis?topic=cis-migrating-to-custom-rules&format=markdown).
{: deprecated}

IBM Cloud&reg; Internet Services firewall rules offer power and flexibility by targeting HTTP traffic and applying custom criteria to block, challenge, log, or allow certain requests.
{: shortdesc}

You can create many types of firewall rules. However, the number of active rules on your site is limited by your customer plan. For more information on entitlements, see [Comparing CIS plans](https://cloud.ibm.com/docs/cis?topic=cis-cis-plan-comparison&format=markdown).

The number of active rules per plan is fixed. Currently, you can't purchase more active rules.

Before getting started, it's a good idea for you to become familiar with [Using fields, functions, and expressions](https://cloud.ibm.com/docs/cis?topic=cis-fields-and-expressions&format=markdown).
{: important}

## Creating a firewall rule
{: #create-firewall-rule}

Follow these steps to configure a basic firewall rule:

1. Navigate to **Security > Firewall rules**.
2. Click **Create**.
3. Enter an optional description.
4. Optionally, input a priority, if necessary. A priority of zero is a null priority and is evaluated last.
5. Use the UI builder in the **Incoming requests** section to add a condition.
    To build an expression with multiple conditions, click either:
    * **And** - to evaluate conditions that use _and_ logic
    * **Or** - to evaluate conditions or groups of previously _and_'ed conditions that use _or_ logic

    You can see that as you build a condition, the Expression Preview shows the expression in plain text.

    In the Expression preview, you can click to edit your expression manually instead of using the Visual Expression Builder, or switch between the two. However, depending on the complexity of a manually constructed expression, the Visual Expression Builder might be unable to render it.
    {: note}

6. Pick an action from the **Response** list menu.
7. To save your rule, choose the most appropriate option by clicking either:
    * **Save as draft** to save your rule, but leave it disabled.
    * **Save and deploy** to save your rule and activate it.

## Editing a firewall rule
{: #edit-firewall-rule}

Follow these steps to edit an existing rule:

1. Navigate to **Security > Firewall rules**.
1. In the firewall rules table, locate the rule that you want to modify, then click the Actions menu on the right of the row.
1. Select **Edit**.
1. Make your changes to the rule.
1. To save your rule, choose the most appropriate option by clicking either:
    * **Save as draft** to save your rule, but leave it disabled.
    * **Save and deploy** to save your rule and activate it.

To pause or activate any rule in the list of existing rules, click the **Enabled** toggle.
{: note}

## Deleting a firewall rule
{: #delete-firewall-rule}

Follow these steps to delete an existing rule:

1. Navigate to **Security > Firewall rules**.
1. In the firewall rules table, locate the rule to modify and click the Actions menu on the right of the row.
1. Select **Delete**.
1. Confirm the rule deletion.