Install
Works with Drupal: ^11.2 || ^12Using Composer to manage Drupal site dependencies
Alternative installation files
Release notes
Second release candidate for Same Page Preview 3.0. This release combines Drupal compatibility fixes with improvements to the editor preview workflow, layout, and accessibility.
Requirements
Requires PHP 8.3 or newer and Drupal 11.2 or newer. The module permits Drupal 12 development versions for compatibility testing; complete Drupal 12 compatibility is still being validated. Drupal 10 is no longer supported by the 3.0.x branch; Drupal 10 sites should remain on 2.1.x.
Fixes and improvements
- Preview incomplete drafts with current field values without displaying required-field errors in the preview; normal Save validation remains in place.
- Preserve selected view modes across refresh, form rebuild, new-window preview, and return to editing.
- Refresh the preview after committed tabledrag and Paragraphs reorder.
- Prevent Domain Source save redirects during preview, refresh existing drafts, and handle cross-origin previews.
- Keep the preview aligned after window resize and bound its width around the editing form in narrow, full-screen, and RTL layouts.
- Add loading feedback, a skip-to-preview control, a named preview region and heading, and editor focus return when the preview closes.
- Use native settings checkboxes and an accessible disclosure with Escape dismissal.
- Fix Drupal 11.4 preview-controller compatibility, duplicate legacy hooks, preview-controls constructor compatibility, and settings-form serialization.
- Preserve editor history during rapid preview refresh and improve test fixtures and CI configuration.
Validation and remaining work
Current and next-major Composer, PHPUnit, and PHPStan checks passed in GitLab CI, together with the inherited coding and lint checks. The JavaScript regression suite passes all 75 tests. Manual screenreader and true browser zoom checks remain follow-up work before a stable release.
HTMX 4 preparation is maintained separately and is not included in rc2.
See the editor workflow merge request and the passing release-candidate pipeline for details.