Cloudflare Docs
Edit this page
Give us feedback
Set theme to dark (⇧+D)

Create a rewrite URL rule in the dashboard

Refer to URL rewrite examples for examples of rule definitions.

To create a rule:

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

  2. Go to Rules > Transform Rules.

  3. In the Rewrite URL tab, select Create rule.

    The rewrite URL rule creation page in the Cloudflare dashboard.
  4. In the rule creation page, enter a descriptive name for the rule in Rule name.

  5. Under When incoming requests match, select if you wish to apply the rule to all incoming requests or only to requests that match a custom filter expression.

  6. (Optional) To define a custom expression, use the Expression Builder (specifying one or more values for Field, Operator, and Value) or manually enter an expression using the Expression Editor. For more information, refer to Edit expressions in the dashboard.

  7. Define the action for your rewrite URL rule by selecting one of the available options displayed as radio buttons, and then a value from the drop-down list, depending on the action:

    • If you select Rewrite to > Static, enter the string that will replace the original URL path (or query string). For example, enter welcome-gb.html to rewrite the original URL path to /welcome-gb.html.

    • If you select Rewrite to > Dynamic, enter a rewrite expression that defines the dynamic URL rewrite to perform.

    • If you do not want to change the value of a component of the original request (the URL path or the URL query string), choose the Preserve action for that component.

    For more information, refer to URL rewrite parameters.

  8. To save and deploy your rule, select Deploy. If you are not ready to deploy your rule, select Save as Draft.

If you choose to deploy your rewrite URL rule, the new rule will be enabled. If you save the rule as a draft, the new rule will be disabled.