Skip to content

Headings support for Word Online while pasting. #70771

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
ellatrix merged 3 commits into from
Dec 11, 2025
Merged

Headings support for Word Online while pasting. #70771

ellatrix merged 3 commits into from
Dec 11, 2025

Conversation

@mecskyverse
Copy link
Contributor

@mecskyverse mecskyverse commented Jul 18, 2025 •
edited by Mamaduka
Loading

What?

Closes #63824
This PR adds a paste transformer that correctly maps heading tags from Microsoft Word Online to Gutenberg Heading blocks, instead of defaulting to Paragraph blocks.

Why?

Currently, when users copy-paste content from Word Online, all headings are flattened into Paragraph (<p>) blocks, resulting in loss of semantic structure. This makes it tedious for users to manually reapply correct heading levels and poses accessibility and SEO issues. This PR improves that flow by preserving the correct heading levels during paste.

How?

The transformer scans pasted content for <p> tags with role="heading" and aria-level (used by Word Online to represent headings). It replaces them with semantic heading tags based on the aria-level, preserving content and relevant attributes. This ensures correct Heading blocks are generated instead of Paragraph blocks.

Testing Instructions

  1. Create Headings in Word Online using Heading tag at the top.
image

  1. Use keyboard shortcuts to copy those headings and paste in Block Editor (Ctrl+V or Cmd+V).

  2. Use arrow keys to navigate the pasted blocks and ensure that heading blocks are correctly rendered and accessible via keyboard navigation.

Screenshots or screencast

Before

Screen.Recording.2025-07-18.at.1.09.40.PM.mov

After

Screen.Recording.2025-07-18.at.1.29.14.PM.mov

@github-actions
Copy link

github-actions bot commented Jul 18, 2025 •
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.

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

Co-authored-by: mecskyverse <aakashverma1@git.wordpress.org>
Co-authored-by: talldan <talldanwp@git.wordpress.org>
Co-authored-by: Mamaduka <mamaduka@git.wordpress.org>
Co-authored-by: annezazu <annezazu@git.wordpress.org>
Co-authored-by: hanneslsm <hanneslsm@git.wordpress.org>
Co-authored-by: mrwweb <mrwweb@git.wordpress.org>

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

@Mamaduka Mamaduka added [Type] Enhancement A suggestion for improvement. [Feature] Paste labels Jul 18, 2025
@Mamaduka Mamaduka requested a review from ellatrix July 18, 2025 08:05
talldan
talldan reviewed Jul 18, 2025
View reviewed changes
packages/blocks/src/api/raw-handling/readme.md
| MS Word Online | ✓ | ✓ | ✓ | ✓ | n/a | ✓ | ✘ [1] |
| LibreOffice | ✓ | ✓ | ✓ | ✘ [3] | ✓ | ✓ | ✓ |
| Evernote | ✓ | ✘ [5] | ✓ | ✓ | ✓ | ✓ | n/a |
| Evernote | ✓ | ✘ [4] | ✓ | ✓ | ✓ | ✓ | n/a |
Copy link
Contributor

@talldan talldan Jul 18, 2025

Choose a reason for hiding this comment

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

Not related to the PR, but might be a nice change to make

Suggested change
| Evernote | ✓ | ✘ [4] | ✓ | ✓ | ✓ | ✓ | n/a |
| Evernote | ✓ | n/a [4] | ✓ | ✓ | ✓ | ✓ | n/a |

Copy link
Contributor Author

@mecskyverse mecskyverse Jul 18, 2025

Choose a reason for hiding this comment

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

I agree let me know if I should commit this suggestion.

@Mamaduka
Copy link
Member

Mamaduka commented Aug 7, 2025

@mecskyverse, the failing unit test seems to be related to the changes here.

@mecskyverse
Copy link
Contributor Author

mecskyverse commented Sep 22, 2025

Hey @Mamaduka, I've fixed the integration test related to this PR. The currently failing or cancelled unit tests seem to be CI-related, not caused by these changes.

@Mamaduka
Copy link
Member

Mamaduka commented Oct 27, 2025

@mecskyverse, sorry for the late reply.

Do you mind rebasing the branch onto the latest trunk and resolving any merge conflicts?

@mecskyverse mecskyverse force-pushed the feat/headings-support-word-online branch from 7ce858d to 1df28e8 Compare October 27, 2025 11:56
@mecskyverse
Copy link
Contributor Author

mecskyverse commented Oct 27, 2025

No worries @Mamaduka — I’ve rebased the branch onto the latest trunk, resolved the conflicts, and force-pushed the updates.

ellatrix
ellatrix approved these changes Dec 11, 2025
View reviewed changes
Copy link
Member

@ellatrix ellatrix left a comment

Choose a reason for hiding this comment

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

Thanks, this looks good to me

@ellatrix ellatrix merged commit 44eca37 into WordPress:trunk Dec 11, 2025
43 of 44 checks passed
@github-actions github-actions bot added this to the Gutenberg 22.4 milestone Dec 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@talldan talldan talldan left review comments

@ellatrix ellatrix ellatrix approved these changes

Assignees

No one assigned

Labels

[Feature] Paste [Type] Enhancement A suggestion for improvement.

Projects

None yet

Milestone

Gutenberg 22.4

Development

Successfully merging this pull request may close these issues.

Headings not pasted from Word in the browser

4 participants

@mecskyverse @Mamaduka @talldan @ellatrix