{"id":14505,"date":"2026-09-24T10:31:28","date_gmt":"2026-09-24T10:31:28","guid":{"rendered":"https:\/\/playgama.com\/blog\/?p=14505"},"modified":"2026-09-24T10:31:28","modified_gmt":"2026-09-24T10:31:28","slug":"how-to-configure-brotli-compression-and-cache-headers-for-we","status":"publish","type":"post","link":"https:\/\/playgama.com\/blog\/business-faqs\/how-to-configure-brotli-compression-and-cache-headers-for-we\/","title":{"rendered":"How to configure Brotli compression and cache headers for WebGL assets?"},"content":{"rendered":"

Pre-compress .wasm, .data and .js build files with Brotli at build time, serve them with Content-Encoding: br and the correct Content-Type, and set long, immutable cache headers on hashed filenames while keeping the HTML page uncached.<\/strong><\/p>\n

At a glance<\/h2>\n\n\n\n\n\n\n\n
Fact<\/th>\nValue<\/th>\nSource<\/th>\n<\/tr>\n<\/thead>\n
Brotli typically beats gzip on WASM\/data files<\/td>\nsmaller output<\/td>\n<\/td>\n<\/tr>\n
Unity WebGL build compression setting<\/td>\nBrotli or gzip<\/td>\ndocs.unity3d.com<\/a><\/td>\n<\/tr>\n
Godot web export decompression setting<\/td>\nmatches server encoding<\/td>\ndocs.godotengine.org<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Compress the build output once at build time rather than on every request, then tell the server and the browser how to handle it. For Unity, set the WebGL compression format to Brotli in Player Settings before building; Unity writes .br files alongside the .wasm, .data and framework .js files. For Godot, export for web and make sure the export’s compression setting matches what your server will serve – Godot’s loader expects the encoding it was told to expect. See the Unity WebGL manual<\/a> and Godot’s web export docs<\/a>.<\/p>\n

If you publish across multiple platforms, Playgama Bridge<\/a> adapts one HTML5 build to 25+ platforms.<\/p>\n

On the server, serve each .br file with Content-Encoding: br<\/code> and the correct underlying Content-Type<\/code> (application\/wasm, application\/octet-stream, application\/javascript). Most static hosts and CDNs do this automatically if they see a .br extension or if you enable Brotli in their settings; check your host’s docs since behaviour varies.<\/p>\n

For caching: give hashed, versioned filenames (the ones your build tool already generates) a long Cache-Control: public, immutable<\/code> header, since the filename changes whenever content changes. Keep the entry HTML page itself uncached or short-cached so players always get the latest reference to the current build hash. Test with browser devtools network tab: confirm Content-Encoding: br appears and file sizes match the compressed output, not the raw one.<\/p>\n

Sources<\/h2>\n