导航|地址|刷新
Cloudflare Snippets
图
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

/Snippets



Cloudflare Snippets


Last updated May 5, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewSnippets elementsTemplatesAvailabilityLimitsExecution order




Cloudflare Snippets allow you to run short pieces of JavaScript code on Cloudflare's network to customize how requests and responses are handled for your website or application. With Snippets, you can modify HTTP response headers, implement JSON web token (JWT) is a common authentication and authorization method used in web applications and APIs.
" class="glossary-tooltip" tabindex="0" data-astro-cid-hklyqugd>JWT validation, perform complex URL redirects navigate the user from a source URL to a target URL using a given HTTP status code. URL redirection is also known as URL forwarding.
" class="glossary-tooltip" tabindex="0" data-astro-cid-hklyqugd>redirects, and more.

For code samples addressing common use cases, refer to the Examples section.


Note


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




Snippets elements


To create and deploy a snippet, you need to define the following elements:

Snippet rule: A filter expression that determines which requests the Snippet will be applied to. Each snippet can only be associated with one snippet rule.

Code snippet: JavaScript code that runs on the Cloudflare network when a request matches the associated snippet rule.

For more information, refer to How Snippets work and Create a snippet in the dashboard.


Note


If you have used the Cloudflare API to create a code snippet that is not associated with a snippet rule, the Cloudflare dashboard will show that code snippet in a separate tab called Unused Snippets. You can either edit the snippet code and associate it with a snippet rule, or delete the unused code snippet.




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

No

Yes

Yes

Yes

Number of snippets
02550300

Number of snippet subrequests
0235


Each A subrequest is any request that a Snippet makes to either Internet resources using the Fetch API or requests to other Cloudflare services.
" class="glossary-tooltip" tabindex="0" data-astro-cid-hklyqugd>subrequest in a redirect chain counts against the subrequest limit. This means that if a subrequest was redirected it would count as two subrequests. To avoid issues, ensure that you make a subrequest to the end location of the redirect chain.

Currently, Version Management does not support Snippets.


Limits


Cloudflare Snippets are designed for fast, lightweight logic that runs on the Cloudflare network. The following limits apply:


DescriptionAll plans
Maximum execution time5 ms
Maximum memory2 MB
Maximum total package size32 KB












Need guidance on choosing between Snippets and Workers?


Explore our detailed guide for best practices, real-world use cases, and example implementations.




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.




PreviousDefine a single configuration rule using TerraformNextHow it works


Was this helpful?

YesNo

Edit pageReport issue




On this page

Overview

Snippets elements

Templates

Availability

Limits

Execution order


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




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