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

Slug, tags, categories and SEO from the document

Write the post’s details into the document once, and every import fills them in for you instead of you typing them on the Preview screen.

In a Markdown file: front matter

Put a front matter block at the very top of the file, between two lines of three dashes:

---
title: How to brew cold coffee
slug: cold-brew-guide
excerpt: A slow, sweet coffee you make the night before.
tags: coffee, recipes
categories: Guides
---

The article starts here…
KeyFills in
titleThe post title.
slugThe permalink. It stays put when you edit the title on the Preview screen.
excerptThe excerpt.
tags or tagTags. A comma-separated line or a YAML list both work.
categories or categoryCategories, matched by name to the ones on your site.
date, or failing that createdThe post’s date, if you choose Document’s date (Pro 1.5.5+). See keeping the document’s date.

Other keys, such as an Obsidian or Jekyll layout, are ignored rather than shown in the post.

In a Word document: its properties

Word keeps a Title and Keywords for every document, under File → Info → Properties. DocxToWP reads both:

  • Keywords become tags. Separate them with commas or semicolons.
  • Title is used when no heading opens the document. A heading always wins, because the Title property is often left over from a template.
  • Created, the day the file was first saved, can become the post’s date in Pro.

Categories that do not exist yet

A category the document names but your site does not have is shown on the Preview screen marked new, unticked. It is only created if you tick it, so a typo in a document never adds a stray category. Users who are not allowed to create categories are told which ones were left out instead.

SEO title, meta description and slug lines (Pro)

With Yoast SEO or Rank Math active, DocxToWP Pro reads these lines from the top of a Word or Google document and moves them into the SEO plugin, taking them out of the post:

SEO title: Cold brew coffee at home | The Daily Grind
Meta description: Make smooth cold brew with two ingredients and one night in the fridge.
URL slug: cold-brew-guide

How to brew cold coffee   ← your Heading 1
Any of these labelsFills in
SEO title, SEO meta title, Meta titleThe SEO title in Yoast SEO or Rank Math.
SEO description, SEO meta description, Meta descriptionThe meta description.
URL slug, Post slug, SlugThe permalink.

For a line to be read:

  • It sits at the very top, above or just below the title, before the article starts.
  • It has a value after the colon. An empty “SEO title:” line is left alone.
  • A slug is one word or hyphenated words, with no spaces.

Without Yoast SEO or Rank Math, the SEO title and description lines stay in the post as ordinary text, so nothing you wrote is lost. The slug line still sets the permalink.

Keeping the document’s date (Pro)

Moving an archive of older articles? From Pro 1.5.5 a post can keep the date its document gives instead of the day you import it, so it takes its proper place in your archive.

  • Where the date comes from: a Markdown file’s date: line, or created: if there is no date:. For a Word document, the day Word says the file was created.
  • One document: on the Preview screen, set Post date to Document’s date. The choice only appears when the document has a date, and Import day stays the default.
  • A bulk import: set Post date under Applies to every document. The review table then shows each document’s date, and any row can keep the import day instead.

A past date publishes the post back-dated, and a draft keeps the date for when you publish it. Dates written with a time zone, such as 2024-03-09T14:30:00Z, are converted to your site’s time. A date in the future is never used, because that would schedule the post without you asking; use the Scheduled status or drip publishing for that. Neither works together with this: a scheduled post already has its date.

Word’s Created date is when the file was first saved. A file copied from an old one, or made from a template, can carry a date that is not when it was written, so check the date shown before you publish.

Checking what was read

When a document fills in any of these, the Preview screen opens with a note, “Read from the document: …”, naming each field. Everything stays editable, so you can still change a value before publishing.

In a bulk import (Pro)

When more than one source sets the same field, the most specific one wins:

  1. A value you type for one document, in its SEO details on the review table.
  2. The document’s own lines or front matter.
  3. The job’s templates under Fill SEO fields from these templates.

A document’s own lines are used even with the templates turned off. More in Bulk import up to 100 documents.

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