Black Friday20% off ProPlans →
Back to docs
Step 3 of 13

What imports and what doesn’t

Everything a Word document, Google Doc or Markdown file can contain, and exactly what DocxToWP does with it.

Text and structure

In your documentIn WordPressPlan
Headings (Heading 1 to 6)Real headings at the same level. The heading that opens the document becomes the post title.Free + Pro
ParagraphsParagraphs. Alignment (centre, right, justified) is kept.Free + Pro
Bold, italic, underline, strikethroughKept.Free + Pro
Superscript and subscriptKept, for ™, footnote-style markers, chemistry and maths notation.Free + Pro
Bulleted and numbered listsLists, nested to any depth, bullets and numbers as in Word.Free + Pro
QuotesWord’s Quote and Intense Quote styles become quotes.Free + Pro
TablesTables, with their header row as table headings.Free + Pro
LinksKept, to the same address.Free + Pro
Block editor outputReal blocks (heading, paragraph, list, table, image), or classic HTML if you choose it in Settings.Free + Pro

Colour and emphasis

In your documentIn WordPressPlan
Highlighted textKeeps its highlight colour: yellow stays yellow.Pro
Coloured textKeeps its colour. Black is left alone, so your theme still controls body text.Pro
Fonts and font sizesNot copied. Your theme’s typography is used, so imported posts match the rest of your site.Free + Pro
Shaded paragraphs (callout boxes)In an Elementor layout, each run of shaded paragraphs becomes one box with that background.Pro

Pictures and media

In your documentIn WordPressPlan
Pictures in the documentUploaded to the Media Library as real images and placed where they were, with Word’s alt text. Never stored as Base64 in the post.Free + Pro
The same picture in many documentsStored once. Matched on its contents, not its file name.Pro
JPEG and PNG picturesConverted to WebP as they are imported, only when that makes them smaller.Pro
A YouTube or Vimeo link on a line of its ownA playable video. A link inside a sentence stays a link.Free + Pro
A line with only [image] or [image: file.webp]In an Elementor layout, an Image widget to fill in, filled already if that file is in your Media Library.Pro
Charts and SmartArtNot imported. Copy the chart into the document as a picture first.Free + Pro
EquationsNot imported. Paste them in as a picture, or use a maths plugin in WordPress.Free + Pro
Embedded files and videos inside the .docxNot imported. Link to them instead, or upload them to WordPress.Free + Pro

Page layout

In your documentIn WordPressPlan
Text boxesTheir text is imported, after the main text of the document.Free + Pro
Newsletters, brochures and flyers built from text boxesWith “Preserve the page layout”, rebuilt as columns and panels that stack on a phone.Pro
Page breaks and horizontal linesIn an Elementor layout, each one starts a new container.Pro
Columns, margins and page sizeNot copied. The web page follows your theme’s width.Free + Pro
Headers, footers and page numbersNot imported. They belong to the printed page, not the post.Free + Pro
An automatic table of contentsNot rebuilt as a working contents block. Delete it before importing, or let a WordPress plugin build one.Free + Pro

Notes, comments and changes

In your documentIn WordPressPlan
Footnotes and endnotesNumbered and linked both ways. In the block editor they go into WordPress’s Footnotes block; otherwise a numbered list at the end of the post. Not yet with “Preserve the page layout”.Free 1.5.0+, Pro 1.5.4+
CommentsNot imported.Free + Pro
Tracked changesImported as the document stands: insertions are kept, deletions are left out.Free + Pro

Details about the post

In your documentIn WordPressPlan
Markdown front matter: title, slug, excerpt, tags, categoriesFill in the Preview screen. Other keys, apart from the date below, are ignored.Free + Pro
Word’s Title and Keywords (File → Info)Title is used when no heading opens the document; Keywords become tags.Free + Pro
“SEO title:”, “Meta description:” and “URL slug:” lines at the topMoved into Yoast SEO or Rank Math and the permalink, out of the post.Pro
A front matter date: or created:, or Word’s Created dateThe post can keep it as its date, if you choose Document’s date. Otherwise it is dated the day you import it.Pro 1.5.5+

More on these in slug, tags, categories and SEO from the document.

Markdown files

In your documentIn WordPressPlan
Headings, emphasis, links, lists, quotes, tables, horizontal rulesKept, as with Word.Free + Pro
Fenced code blocksCode blocks, with the code exactly as written.Free + Pro
Images with a full https:// addressKept as external images.Free + Pro
Images with a relative path, such as images/photo.jpgLeft out on a single import, and the Preview screen lists them. In Bulk Import, matched to image files you drop in alongside.Free + Pro
Raw HTMLKept where WordPress allows it; scripts and unsafe markup are removed.Free + Pro
Footnotes written as [^1]Left as text.Free + Pro

Limits

  • File size: set under Settings → Max File Size (MB), and capped by your host’s upload limit.
  • Documents per run: one at a time in the free plugin, with no limit on how many. Up to 100 per Bulk Import in Pro.
  • File types: .docx and .md (or .markdown). An old .doc file needs saving as .docx in Word first.

If a document looks empty

If the importer says there is no importable text but you can see words in the document, the text is almost always in a header, footer, comment or SmartArt graphic, which Word keeps outside the document body. Copy the text into a blank document and import that.

Still stuck? Email support@docxtowp.com and we will walk you through it.