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

Import your first document

From a Word or Markdown file to a WordPress post, one screen at a time. It takes about a minute.

Before you start

  • The plugin is installed and active. If not, see the installation guide.
  • Your document uses Word’s real heading styles (Heading 1, Heading 2…) rather than large bold text. Headings are what become headings in WordPress.
  • Unsure what will come across? What imports and what doesn’t lists every element.

1. Open the upload screen

In the WordPress sidebar, open DocxToPost (the free plugin) or DocxToWP Pro, then Upload Document. If you left an import unfinished, a note at the top offers Continue editing →.

2. Choose where the document comes from

The upload screen has three tabs:

TabWhat it does
Upload a fileDrop a .docx or .md file on the box, or click it to browse.
Google Docs link (Pro: From Google Docs)Paste a link to a Google Doc shared as “Anyone with the link”. In Pro you can also click Choose from Google Drive and pick private documents. See Import from Google Docs.
Media LibraryUse a .docx that is already uploaded to your site. The file in the library is left untouched.

Pro only: under Import Mode, tick Preserve the page layout for a newsletter, brochure or flyer built from text boxes. The columns and panels are rebuilt as a responsive layout instead of one column of text. Leave it unticked for ordinary articles.

3. Add a featured image (optional)

Under Featured Image, upload a JPEG, PNG, GIF or WebP, or click Choose from Media Library. You can skip this and set one later in WordPress.

4. Click Convert & Preview

The document is read, its pictures are uploaded to the Media Library, and the Preview & Publish screen opens. Nothing is published yet.

5. Check the Preview screen

It is laid out like the WordPress editor. Work down it:

  • Title.Taken from the heading that opens the document. If no heading opens it, from the Title in the document’s properties, and failing that from the file name.
  • Permalink. Follows the title. Click Edit to set your own. If the document gave a slug, that one is used and stays put when you edit the title.
  • Document Content. The converted document, editable. Fix a typo here if you spot one.
  • Excerpt. Optional, shown in search results and archives.
  • SEO (Pro, with Yoast SEO or Rank Math active): SEO title, focus keyphrase and meta description.

In the sidebar:

  • Post Type. Posts, Pages or any public custom post type on your site, in the free plugin as well as Pro.
  • Status. Published, Draft, Pending Review or Private. Pro adds Scheduled, with a Publish on date.
  • Post date (Pro, when the document has a date): Import day, or Document’s date to publish the post with the date its document gives. See keeping the document’s date.
  • Author, Categories and Tags.
  • Build an Elementor layout (Pro, on sites running Elementor). See Import into an Elementor layout.

Notes can appear at the top of the screen:

  • “Read from the document: …” lists the fields the document filled in itself, such as the slug or tags. See slug, tags, categories and SEO from the document.
  • “A post with this title already exists.” Publishing creates a second post, it does not replace the first.
  • “Some of the document could not be imported.” Lists what was left out, for example a Markdown image with a relative path.

6. Publish

Click Publish (it changes to match the status you chose), confirm, or click Save Draft to keep it private for now. The confirmation screen links to the post:

  • View or Preview it on your site.
  • Edit in WordPress, or Edit with Elementor for an Elementor layout.
  • Upload Another to start the next one.
  • In the free plugin, Move to trash if it is not what you expected. It can be restored from the Trash.

What happens to your file

The uploaded .docx is only kept while you work on it, in a temporary folder, and is cleared afterwards. The post is an ordinary WordPress post: it stays exactly as it is whatever happens to the plugin later.

Next

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