godaddy-wordpress / godaddy-wordpress/coblocks
WordPress 7.0 Compatibility Review
- Dominant language
- JavaScript
- Stars
- 794
- Forks
- 142
- PR merge metrics
- No merged PRs in 30d
Description
## Overview
WordPress 7.0 is scheduled for release on **April 9, 2026**. This issue tracks the work needed to ensure CoBlocks is fully compatible. Beta 1 is already available for testing.
- [WordPress 7.0 Beta 1 announcement](https://wordpress.org/news/2026/02/wordpress-7-0-beta-1/)
- [Help Test WordPress 7.0](https://make.wordpress.org/test/2026/02/20/help-test-wordpress-7-0/)
- [WordPress 7.0 release schedule](https://make.wordpress.org/core/7-0/)
- Official Field Guide expected: **March 19, 2026**
---
## Critical: Post Editor Always Iframed (Block API v2 Deprecated)
**This is the highest-risk change for CoBlocks.**
In WordPress 7.0, the post editor will **always run inside an iframe**, removing the legacy fallback that previously allowed blocks using API v1/v2 to opt out. Block API v2 has been deprecated since WP 6.9.
### Affected CoBlocks blocks
**Explicitly on `apiVersion: 2`** (must be migrated to v3):
- `click-to-tweet`
- `counter`
- `gallery-masonry`
- `gallery-stacked`
- `highlight`
- `testimonials/testimonial`
**No `apiVersion` declared** (default to v1 — also deprecated): 51 additional `block.json` files across the plugin need auditing.
### Migration requirements
- Update `apiVersion` to `3` in all `block.json` files
- Audit JS in each block for use of global `document` or `window` — these will break in the iframe context where the editor's `document` is different from the admin page
- Replace any direct DOM access with `useRefEffect` or other iframe-safe APIs
- Reference: [Migrating Blocks for iframe Editor Compatibility](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/block-migration-for-iframe-editor-compatibility/)
---
## Additional Changes to Assess
- **`HtmlRenderer` component (Gutenberg 22.4):** Several blocks will lose an extra wrapping `
- **New global block supports** (text indent, text columns, image aspect ratios for wide/full): Check if CoBlocks' custom implementations conflict with new core features
- **`isNotAll` operator deprecated** in query APIs — may affect the Posts block
- **`theme.json` link underline removed** — audit any styling that relied on this default
- **PHP minimum raised to 7.4** — CoBlocks already requires 7.4, so no change needed here
---
## CI Updates Required
The `test-wp-next.yml` workflow needs to be updated:
- `scheduled_release_date` is stale (set to `2024-04-02`)
- `wp_next` URL still points to `wordpress-6.8-RC2.zip`
- Update to point at WordPress 7.0 beta/RC zip and adjust `installPath`
---
## Checklist
- [ ] Update `test-wp-next.yml` to target WP 7.0 Beta 1
- [ ] Audit all 57 `block.json` files — identify which need `apiVersion: 3`
- [ ] Migrate all blocks to `apiVersion: 3`
- [ ] Audit block JS files for `document`/`window` global access in iframe-unsafe ways
- [ ] Fix any iframe compatibility issues found
- [ ] Review Field Guide dev notes once published (March 19)
- [ ] Run full Cypress E2E suite against WP 7.0
- [ ] Run PHP unit tests against WP 7.0
- [ ] Update `readme.txt` and `package.json` `tested_up_to` to `7.0`
Contributor guide
Assessment
This issue has not been assessed yet.