Frontmatter

The frontmatter at the top of a file, as copyable templates.

Every post and doc starts with a frontmatter block between two lines of ---. Copy the appropriate template below and paste it at the top of your Markdown file.

Blog post template

---
title: "10 Ways to Speed Up WooCommerce Checkout"   # the headline on the page
description: "Cut cart abandonment with tested fixes from real stores."
                                     # shown under the title; for readers
seo_description: "Speed up WooCommerce checkout and cut cart abandonment with 10 tested fixes. Real stores, real numbers, no plugins needed."
                                     # Google's snippet; 140-160 characters
seo_title: "Speed Up WooCommerce Checkout (2026)"   # optional; only if title > 60 chars
date: 2026-03-15
updated: 2026-03-20                  # optional; when you revise it
author: "nirav-mehta"                # your author name, as the admin gave it to you
category: "woocommerce"              # exactly one
tags: ["speed", "checkout", "conversion"]           # 2 to 5
featured_image: "/media/checkout-speed.webp"
status: draft                        # change to published when it's ready
---

Documentation template

---
title: "How to Set Up Amazon SES as Your Sending Service"
navLabel: "Amazon SES setup"         # short name for the sidebar, 1-3 words
description: "Connect Amazon SES in five minutes."
seo_description: "Step-by-step guide to connecting Amazon SES to Icegram Express, with DNS records, sending limits and a test email."
order: 3                             # position in the sidebar; lower comes first
status: published
---

Key rules

description vs seo_description

description is the standfirst shown under the title on the page for human readers. seo_description is the search snippet Google displays in results. Write both. If seo_description is left blank, the site falls back to description.

One category, a few tags

A post has exactly one category. The category defines the post’s topic cluster, breadcrumb trail, and archive URL. Tags are cross-cutting labels (2 to 5 per post).

Quotes in values

If a value contains a colon : or quotation mark ", wrap the whole string in double quotes: title: "Case Study: How We Scaled Email Delivery"

For docs, category icons and order are configured centrally by the site administrator in brand/docs-categories.md, not inside individual doc files.