close
Skip to content

Docs: Update iframe editor migration guide for WordPress 7.0/7.1#78401

Merged
t-hamano merged 3 commits into
trunkfrom
docs/update-iframe-migration-guide
May 21, 2026
Merged

Docs: Update iframe editor migration guide for WordPress 7.0/7.1#78401
t-hamano merged 3 commits into
trunkfrom
docs/update-iframe-migration-guide

Conversation

@t-hamano
Copy link
Copy Markdown
Contributor

@t-hamano t-hamano commented May 18, 2026 •
edited
Loading

Closes #73138

What?

Updates the "Migrating Blocks for iframe Editor Compatibility" guide so it reflects the current iframe rollout plan.

Why?

The guide contained outdated and inaccurate information.

How?

  • Corrects the iframe condition to evaluate blocks present in the content.
  • Moves the "always iframe" target from WordPress 7.0 to 7.1.
  • Condenses the WordPress 6.9 section and links to the related Make/Core post.
  • Adds a short note on the WordPress 7.0 change (inserted-block evaluation) with a reference link.
  • Adds a new "Patching a library" section describing how to patch external libraries for iframe compatibility using patch-package.

Testing Instructions

  1. Open the updated document: https://github.com/WordPress/gutenberg/blob/docs/update-iframe-migration-guide/docs/reference-guides/block-api/block-api-versions/block-migration-for-iframe-editor-compatibility.md#when-does-the-post-editor-work-as-an-iframe
  2. Confirm the content reads correctly and all links resolve.

Use of AI Tools

This PR was authored with the assistance of Claude (Claude Code). All content was reviewed by the contributor.

t-hamano and others added 2 commits May 18, 2026 22:47
@t-hamano @claude
Docs: Update iframe editor migration guide for WordPress 7.0/7.1
1e4454c 
The guide described iframe behavior that no longer matches the planned
rollout. Correct the conditions so the post editor is iframed based on
blocks present in the content (not all registered blocks), move the
"always iframe" target to WordPress 7.1, and condense the 6.9 section.
Add the WordPress 7.0 change explaining inserted-block evaluation, and
a new section on patching external libraries for iframe compatibility.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@t-hamano @claude
Docs: Remove duplicated colon in iframe condition list items
e6e23e2 
The bold labels ended with "**:**:", producing a doubled colon in the
rendered output. Drop the redundant trailing colon.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@t-hamano t-hamano self-assigned this May 18, 2026
@t-hamano t-hamano added the [Type] Developer Documentation Documentation for developers label May 18, 2026
@t-hamano t-hamano marked this pull request as ready for review May 18, 2026 13:53
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 18, 2026 •
edited
Loading

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Unlinked Accounts

The following contributors have not linked their GitHub and WordPress.org accounts: @merijnponzo.

Contributors, please read how to link your accounts to ensure your work is properly credited in WordPress releases.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Unlinked contributors: merijnponzo.

Co-authored-by: t-hamano <wildworks@git.wordpress.org>
Co-authored-by: Mamaduka <mamaduka@git.wordpress.org>
Co-authored-by: mrleemon <leemon@git.wordpress.org>
Co-authored-by: stokesman <presstoke@git.wordpress.org>
Co-authored-by: youknowriad <youknowriad@git.wordpress.org>
Co-authored-by: ellatrix <ellatrix@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@github-project-automation github-project-automation Bot moved this to 🔎 Needs Review in WordPress 7.0 Editor Tasks May 18, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 18, 2026 •
edited
Loading

Flaky tests detected in 7715347.
Some tests passed with failed attempts. The failures may not be related to this commit but are still reported for visibility. See the documentation for more information.

🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/26156010587
📝 Reported issues:

Mamaduka
Mamaduka approved these changes May 20, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@Mamaduka Mamaduka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @t-hamano!

@t-hamano t-hamano merged commit d481fba into trunk May 21, 2026
39 checks passed
@t-hamano t-hamano deleted the docs/update-iframe-migration-guide branch May 21, 2026 03:24
@github-project-automation github-project-automation Bot moved this from 🔎 Needs Review to ✅ Done in WordPress 7.0 Editor Tasks May 21, 2026
@github-actions github-actions Bot added this to the Gutenberg 23.3 milestone May 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Mamaduka Mamaduka Mamaduka approved these changes

@ellatrix ellatrix Awaiting requested review from ellatrix

@stokesman stokesman Awaiting requested review from stokesman

@ajitbohra ajitbohra Awaiting requested review from ajitbohra ajitbohra is a code owner

@juanmaguitar juanmaguitar Awaiting requested review from juanmaguitar juanmaguitar is a code owner

@fabiankaegy fabiankaegy Awaiting requested review from fabiankaegy fabiankaegy is a code owner

Assignees

@t-hamano t-hamano

Labels

[Type] Developer Documentation Documentation for developers

Projects

WordPress 7.0 Editor Tasks
Status: ✅ Done

Milestone

Gutenberg 23.3

Development

Successfully merging this pull request may close these issues.

Documentation to help with the migration to Block API version 3

2 participants

@t-hamano @Mamaduka