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…| Key | Fills in |
|---|---|
title | The post title. |
slug | The permalink. It stays put when you edit the title on the Preview screen. |
excerpt | The excerpt. |
tags or tag | Tags. A comma-separated line or a YAML list both work. |
categories or category | Categories, matched by name to the ones on your site. |
date, or failing that created | The 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 labels | Fills in |
|---|---|
| SEO title, SEO meta title, Meta title | The SEO title in Yoast SEO or Rank Math. |
| SEO description, SEO meta description, Meta description | The meta description. |
| URL slug, Post slug, Slug | The 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, orcreated:if there is nodate:. 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:
- A value you type for one document, in its SEO details on the review table.
- The document’s own lines or front matter.
- 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.