All Products
Search
Document Center

Edge Security Acceleration:Configure Brotli compression

Last Updated:Sep 16, 2026

Brotli is an open-source compression algorithm that provides better performance than Gzip compression. After you enable Brotli compression, DCDN points of presence (POPs) compress resources with Brotli before returning them to clients. This reduces the size of transferred files, improves delivery efficiency, and reduces bandwidth consumption.

Background information

  • Compression can be implemented by using Gzip or Brotli. Intelligent compression uses Gzip to compress files. For more information about intelligent compression, see Gzip compression.

  • You can use the Gzip compression or Brotli compression feature to compress the files only if the size of files on the origin server ranges from 1 KB to 10 MB. Files that are smaller than 1 KB or larger than 10 MB are not compressed.

  • Brotli compression supports the following formats: text/xml, text/plain, text/css, application/javascript, application/x-javascript, application/rss+xml, text/javascript, image/tiff, image/svg+xml, application/json, and application/xml.

  • If a response from the origin server includes the Content-Encoding: br response header, the resources that are returned to the client are Brotli-compressed.

  • If a request includes the Accept-Encoding: br request header, the client expects the requested resources to be Brotli-compressed.

Usage notes

  • When DCDN compresses static files, the MD5 values of the files are changed. If files on the origin server have MD5 verification enabled, disable Gzip compression and Brotli compression.

  • If compression is enabled on the origin server and the response from the origin server carries content_encoding, compression on POPs does not take effect.

  • If both Brotli compression and Gzip compression are enabled, and the Accept-Encoding request header includes both br and gzip, only Brotli compression takes effect.

  • If both HTML optimization and compression are enabled, HTML optimization does not take effect. DCDN only compresses files.

  • Brotli is not compatible with all browsers. You can query whether a browser is compatible with Brotli as needed.

  • Image files (PNG, JPG, JPEG) and video files (MP4, AVI, WMV) are already compressed. Intelligent compression and Brotli compression do not take effect on these file types. Disable compression for them. To reduce image size, use Image editing and its benefits. To reduce video size, use Audio and video transcoding. Both methods reduce image resolution.

Procedure

  1. Log on to the DCDN console.

  2. In the left-side navigation pane, click Domain Names.

  3. On the Domain Names page, find the target domain name and click Configure.

  4. In the left-side navigation pane of the domain name, click Optimization.

  5. In the Brotli Compression section, turn on Brotli Compression.

    After you enable Brotli compression, check the file extension. A .br extension indicates that compression is applied.