导航|地址|刷新
Origin Rules
图
Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/rules/llms.txt
Use this file to discover all available pages before exploring further.



DocsDirectoryAPISDKsChangelog

Search

Log in






Rules

/




Overview

Examples


Configuration Rules


Overview

Create a rule in the dashboard

Create a rule via API

Available settings


Examples


Overview

Define a single configuration rule using Terraform










Snippets


Overview

How it works

Create in the dashboard

Configure via API

Configure using Terraform

Examples

Troubleshooting

When to use Snippets vs Workers






Transform Rules


Overview


Rewrite URLs


Overview

Create a rule in the dashboard

Create a rule via API

Create a rule using Terraform ↗


Reference


URL rewrite parameters

Available fields and functions










Modify request headers


Overview

Create a rule in the dashboard

Create a rule via API

Create a rule using Terraform ↗


Reference


Format of header names and values

Available fields and functions

API parameter reference










Modify response headers


Overview

Create a rule in the dashboard

Create a rule via API

Create a rule using Terraform ↗


Reference


Format of header names and values

Available fields and functions

API parameter reference










Managed Transforms


Overview

Configure Managed Transforms

Available Managed Transforms





Troubleshooting


Examples


Overview

Add a request header for subrequests from other zones

Add a request header with the current bot score

Add a response header with a static value

Add a wildcard CORS response header

Add request header with a static value

Normalize encoded slashes in URL path

Remove a request header

Remove a response header

Rewrite blog archive URLs

Rewrite image paths with several URL segments

Rewrite page path for visitors in specific countries

Rewrite path for object storage bucket

Rewrite path of archived blog posts

Rewrite path of moved section of a website

Rewrite URL query string

Set a response header with the current bot score

Set response header with a static value










Redirects


Overview


Single Redirects


Overview

Create rule in the dashboard

Create rule via API

Create rule using Terraform

Available settings






Bulk Redirects


Overview

Concepts

How it works

Create in the dashboard

Create via API

Configure using Terraform


Reference


URL redirect parameters

Supported URL components

Available fields and functions

CSV file format

API JSON objects





FAQ






Examples


Overview

Perform mobile redirects

Redirect admin area requests to HTTPS

Redirect from root to WWW

Redirect from WWW to root

Redirect local visitors to specific subdomains

Redirect requests for a domain to a new domain

Redirect requests from one country to a domain

Redirect requests from one domain to another

Redirect requests to a different hostname

Redirect visitors to a new page URL

Remove locale from URL path










Origin Rules


Overview

Create a rule in the dashboard

Create a rule via API


Examples


Overview

Change the destination port

Change the HTTP Host header and DNS record

Define a single origin rule using Terraform






Tutorials


Overview

Change URI path and Host header

Point to Pages with a custom domain

Point to R2 bucket with a custom domain





Available settings

API parameter reference

FAQ





Cache Rules ↗


Cloud ConnectorBeta


Overview

Configure a rule in the dashboard

Configure a rule via API

Configure rules using Terraform

Supported cloud providers


Examples


Overview

Route /images to an S3 Bucket

Route /images to an S3 Bucket using Terraform

Send EU visitors to a Google Cloud Storage bucket

Serve /static-assets from Azure Blob Storage










Custom Errors


Overview

Edit Error Pages

Create custom error rules

Example rules

Common API calls


Reference


Parameters

Error tokens

Error page types





Troubleshooting






Compression Rules


Overview

Create a rule in the dashboard

Create a rule via API

Available settings


Examples


Overview

Disable Brotli compression

Disable compression for AVIF images

Enable Zstandard compression for default content types

Use Gzip compression for CSV files

Use only Brotli compression for a specific path










Page Rules


Overview

Manage


How to


URL forwarding






Reference


Settings

Additional reference

Wildcard matching

Recommended rules






Troubleshooting


General

Billing and subscription










URL normalization


Overview

How it works

Configure in the dashboard

Settings

Examples






Trace a requestBeta


Overview

Use Cloudflare Trace

Limitations

Changelog






Reference


Rules language ↗

Troubleshooting

Page Rules migration guide





Changelog


Agent resources


Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Rules llms.txt ↗

Rules llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗













Home

/Rules

/Origin Rules



Origin Rules


Last updated Apr 16, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewRules templatesAvailabilityExecution orderImportant remarksTroubleshooting




Origin Rules allow you to change the origin server that Cloudflare sends a request to, or modify how the request reaches that server. This is useful when you need to route specific requests to a different backend, such as a third-party service or a server on a non-standard port. You can perform the following overrides:

Host header: Overrides the Host header of incoming requests.

Server Name Indication (SNI): Overrides the Server Name Indication (SNI) value of incoming requests.

DNS record: Overrides the resolved hostname of incoming requests, sending the request to a different origin server.

Destination port: Overrides the resolved destination port of incoming requests.

Each origin rule includes a filter expression that defines which requests the overrides apply to (for example, matching on hostname, path, or other request properties).

For more complex and customized modifications, consider using Snippets.



Note


Origin Rules require that you proxy the DNS records of your domain (or subdomain) through Cloudflare.




Rules templates


Cloudflare provides you with rules templates for common use cases.


In the Cloudflare dashboard, go to the Rules Overview page.
Go to Overview ↗


Select Templates, and then select one of the available templates.


You can also refer to the Examples gallery in the developer docs.


Availability


FreeProBusinessEnterprise

Availability

Yes

Yes

Yes

Yes

Number of rules
102550300

Override Host header

No

No

No

Yes

Override SNI

No

No

No

Yes

Override DNS records

No

No

No

Yes

Override destination port

Yes

Yes

Yes

Yes



Execution order


The execution order of Rules features is the following:

Single Redirects

URL Rewrite Rules

Configuration Rules

Origin Rules

Bulk Redirects

Managed Transforms

Request Header Transform Rules

Cache Rules

Snippets

Cloud Connector

The different types of rules listed above will take precedence over Page Rules. This means that Page Rules will be overridden if there is a match for both Page Rules and the Rules products listed above.

Generally speaking, for non-terminating actions the last change made by rules in the same phase will win (later rules can overwrite changes done by previous rules). However, for terminating actions (Block, Redirect, or one of the challenge actions), rule evaluation will stop and the action will be executed immediately.

For example, if multiple rules with the Redirect action match, Cloudflare will always use the URL redirect of the first rule that matches. Also, if you configure URL redirects using different Cloudflare products (Single Redirects and Bulk Redirects), the product executed first will apply, if there is a rule match (in this case, Single Redirects).

Refer to the Phases list for the product execution order.


Caution


Using Cloudflare challenges along with Rules features may cause challenge loops. Refer to Rules troubleshooting for more information.




Important remarks


If you override the hostname with an origin rule (via Host header override or DNS record override) and add a header override to your load balancer configuration, the origin rule will take precedence over the load balancer configuration.

Like Page Rules, an origin rule performing a Host header override will update the SNI value of the original request to the same value of the Host header. To set an SNI value different from the Host header override, add an SNI override in the same origin rule or create a separate origin rule for this purpose.


Troubleshooting


When troubleshooting origin rules, use Cloudflare Trace to determine if a rule is triggering for a specific URL.


PreviousRemove locale from URL pathNextCreate a rule in the dashboard


Was this helpful?

YesNo

Edit pageReport issue




On this page

Overview

Rules templates

Availability

Execution order

Important remarks

Troubleshooting


Edit pageReport issue














Getting started
PlansContact salesPartnersFind a partnerStartupsUnder attack?Domain name search


Company
AboutCareersInvestorsPressPress kitGlobal network




Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG


Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse




Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog


Developers
DocumentationLearning centerCommunity




Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform


Start BuildingLog In












© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices








Docs




------
导航页 打开网址