How to Preserve Word Formatting When Publishing to WordPress
The "Paste from Word" button was a staple of the old WordPress Classic Editor. But even then, it was hit-or-miss. With the move to the Gutenberg Block Editor, the challenge has only grown.
Why formatting breaks in copy-paste
When you paste from Word, the browser tries to translate Word's internal styling (MsoNormal classes, etc.) into web-safe HTML. WordPress then tries to "sanitize" that HTML. In this double-translation, things get lost:
- Mso Classes: Word adds proprietary CSS that browsers don't understand.
- Image Paths: Images in Word are local objects; pasting them just inserts a reference that doesn't point to an online file.
- Nested Structures: Word's way of handling nested lists is different from standard HTML, leading to broken indentations.
Using DocxToWP for 100% fidelity
DocxToWP avoids the clipboard entirely. By reading the .docx file directly on the server, we can map Word's internal XML structure to clean WordPress blocks.
- H1–H6: Correctly identified and mapped to Heading blocks.
- Lists: Correctly nested as List blocks.
- Emphasis: Bold, italic, and underline are preserved using clean semantic tags.
- Tables: Converted to Table blocks with alignment and header rows intact.
For best results, use standard Word styles (Heading 1, Heading 2, etc.) rather than just increasing the font size manually.
Related Articles
How to Import Word Documents to WordPress With Inline Images
Pasting text is easy, but images are the hard part. Learn how to automatically extract and upload images from Word to your WP Media Library.
How to Import a Word Document to a WordPress Custom Post Type
DocxToWP isn't just for blog posts. Learn how to import your Word documents directly into WooCommerce products, Portfolios, or any CPT.
How to Upload a .docx File to WordPress and Publish It as a Post
A simple, non-technical guide to uploading Word documents to WordPress. Perfect for beginners who want to avoid the Gutenberg formatting headache.
Start publishing Word docs to WordPress in under 60 seconds
Free. No account. No credit card. Install directly from WordPress.org and transform your content workflow today.