Document Frontmatter

Document frontmatter is the structured metadata added to the beginning of a drafting document (such as a Google Doc) that outlines details like the post’s title, slug, category, tags, status, and publish date.

What Document Frontmatter Means

In web publishing, metadata defines how a page behaves and appears in a Content Management System (CMS) like WordPress. Usually, editors must copy-paste content into the CMS editor and then manually set categories, tags, slugs, and status in the sidebar.

Document frontmatter allows writers to define all of these settings directly inside the document workspace. By using a standardized layout (like a key-value table at the top of a Google Doc), content synchronization tools can automatically read and map these settings during export.

Why Document Frontmatter Matters for Publishing Teams

For busy editorial teams, document frontmatter is a huge time-saver and guard against publishing errors:

• Topical Consistency: Writers and editors don’t need access to the CMS admin panel to assign categories or tags.
• Fewer Manual Steps: Automation tools parse the frontmatter, configure the draft parameters, and post the content in one click.
• Perfect Slugs: You can specify the exact URL slug in the document, avoiding auto-generated CMS slugs that can hurt SEO.

How Frontmatter Fits into Google Docs to CMS Workflows

When drafting in Google Docs, setting up a frontmatter table makes transitions to WordPress or Blogger frictionless:

1. Insert Table: Create a simple 2-column table at the very top of your document.
2. Add Metadata Keys: In the left column, add keys like Title, Slug, Category, Tags, and Status.
3. Fill in Values: In the right column, input the corresponding values (e.g. Tags: SEO, Publishing).
4. Automate Export: Use a tool like Tenwrite to sync the document. The tool extracts this table, configures the post settings in your CMS, and removes the visual table from the published article body.

Common Mistakes

• Incorrect Key Names: CMS and publishing tools expect exact key strings (e.g., Category instead of Categories). Typos will result in ignored metadata.
• Adding Extra Styles: Adding bolding, links, or colors inside frontmatter table cells can sometimes confuse parsing algorithms. Keep values in plain text.
• Placing Text Above the Frontmatter: The frontmatter table should be the absolute first element in the document. Any headers or comments above it may prevent a parser from detecting it.

Example

An editor opens a Google Doc draft for an upcoming feature guide. At the top of the doc is a table specifying Slug: features-release-2026, Category: Product Updates, and Status: draft. When exported, WordPress automatically schedules a draft post at that exact URL, saving the editor from doing it manually in the WordPress block editor.