导航|地址|刷新
Compression 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

/Compression Rules



Compression Rules


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

OverviewGet startedAvailabilityRelevant fieldsImportant remarksTroubleshooting




Use Compression Rules to customize the compression applied to responses from Cloudflare's global network to your website visitors, based on the file extension and content type. Compression Rules are powered by the Ruleset Engine.

Cloudflare compresses some responses by default, based on the content type. With Compression Rules, you can customize the default behavior, which includes defining preferred compression algorithms for particular file types.

When a compression rule matches and lists several compression algorithms (such as gzip and Brotli), Cloudflare selects the first algorithm from your list that the visitor's browser supports. Cloudflare determines browser support from the accept-encoding HTTP request header, which browsers send automatically to indicate which compression formats they can decompress. If multiple compression rules match the same request, the last matching rule takes precedence.


Note


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




Get started


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.

Alternatively, follow the instructions in the following pages to get started:

Create a compression rule in the dashboard

Create a compression rule via Cloudflare API

------


Availability


Compression Rules are available in all Cloudflare plans.

	Free	Pro	Business	Enterprise
Availability	Yes	Yes	Yes	Yes
Number of rules	10	25	50	300

Relevant fields


The following fields are commonly used in expressions of compression rules:

Field in Expression Builder	Field name
Media Type	http.response.content_type.media_type
File extension	http.request.uri.path.extension
N/A	raw.http.request.uri.path.extension

Important remarks



If a compression rule matches but the visitor's browser does not support any of the compression algorithms configured in the rule (based on the accept-encoding request header), the response will not be compressed.



If a compression rule matches but the origin server's response includes a cache-control: no-transform HTTP header, the compression rule will not modify the response. Origin servers use this header to indicate that intermediaries (like Cloudflare) should not alter the response body.



Troubleshooting


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


PreviousTroubleshootingNextCreate a rule in the dashboard


Was this helpful?

YesNo

Edit pageReport issue




On this page

Overview

Get started

Availability

Relevant fields

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




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