This feature enables Alibaba Cloud CDN to automatically remove redundant content from web pages, such as comments and additional whitespace characters in HTML pages, CSS code, and JavaScript code. This reduces file sizes, accelerates content delivery, and improves website readability.

Usage notes

  • If MD5 verification is configured for files on the origin server, do not enable HTML optimization.

    The HTML optimization feature changes the MD5 value of a file. After the file is optimized, the MD5 value of the file is no longer the same as that of the original file stored on the origin server.

  • If the origin server has Gzip or Brotli compression enabled, HTML optimization does not take effect. Alibaba Cloud directly returns compressed files to clients.

    If you want to use the HTML optimization feature in Alibaba Cloud without disabling Gzip or Brotli compression on the origin server, you can delete the Accept-Encoding header from the origin HTTP headers. After you delete the Accept-Encoding header, the HTML optimization feature takes effect. For more information about how to delete the Accept-Encoding header, see Configure custom request headers.

  • If HTML optimization and Gzip or Brotli compression are enabled, HTML optimization takes precedence over compression.
  • In some special cases, if you enable the HTML optimization feature to rewrite HTML files, CSS files, and JavaScript files on the webpages, the business logic of the website may be affected, and an error message similar to the following one may be returned when a client accesses the rewritten webpages: Hydration completed but contains mismatches. To fix the error, disable HTML optimization.

Procedure

  1. Log on to the Alibaba Cloud CDN console.
  2. In the left-side navigation pane, click Domain Names.
  3. On the Domain Names page, find the domain name that you want to manage and click Manage in the Actions column.
    Domain Names
  4. In the left-side navigation pane of the domain name, click Optimization.
  5. In the HTML Optimization section, turn on HTML Optimization, CSS Optimization, or JavaScript Optimization.
    Note The HTML Optimization switch controls only HTML optimization. If you want to enable CSS or JavaScript optimization, you must first turn on HTML Optimization, and then turn on CSS Optimization or JavaScript Optimization.
    Enable HTML optimization
    • Turn on HTML Optimization: Alibaba Cloud CDN optimizes HTML pages.
    • Turn on CSS Optimization: Alibaba Cloud CDN optimizes CSS styling.
    • Turn on JavaScript Optimization: Alibaba Cloud CDN optimizes JavaScript code.

Related API operations

BatchSetCdnDomainConfig