Change8

Migrating to Astro astro@7.0.0-beta.5

Version astro@7.0.0-beta.5 introduces 1 breaking change. This guide details how to update your code.

Released: 6/18/2026

1
Breaking Changes
2
Migration Steps
1
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

compressHTML

Breaking Changes

Issue #1

The default value for the `compressHTML` configuration option has changed from `true` (HTML-aware compression) to `'jsx'`. This means whitespace stripping now follows JSX rules by default, removing surrounding whitespace but preserving meaningful inline spaces. If you relied on the previous behavior, you must explicitly set `compressHTML: true` (for HTML-aware compression) or `compressHTML: false` (to preserve all whitespace) in your configuration.

Migration Steps

  1. 1
    If you require the previous HTML-aware whitespace compression, update your configuration to set `compressHTML: true`.
  2. 2
    If you require all whitespace to be preserved, update your configuration to set `compressHTML: false`.

Release Summary

This release defaults HTML compression to use JSX-style whitespace stripping, which may alter rendered output. Several bugs were fixed related to error handling and custom page rendering within advanced routing setups.

Need More Details?

View the full release notes and all changes for Astro astro@7.0.0-beta.5.

View Full Changelog