Front matter guide
Learn how to configure front matter fields for your blog posts, including required fields, formats, and best practices.
Frontmatter
Every blog post must start with a frontmatter block at the top:
---
title: "template"
date: "2025-10-05"
description: "template file"
author: "Pixelversed Team"
category: "Documentation"
image: "/image.png"
isDraft: true
pinned: false
toc: true
---A ready-to-use template file can be found in src/routes/blog/posts/.template
Required frontmatter fields
| Field | Type | Required | Description |
|---|---|---|---|
title |
string | Yes | The post title |
date |
string | Yes | Publication date (YYYY-MM-DD) |
description |
string | Yes | Brief summary used in previews and meta tags |
category |
string | Yes | Post category (see below) |
author |
string | No | Author name. Defaults to "Pixelversed Team" |
image |
string | No | Path or URL to the post’s cover image. |
isDraft |
boolean | No | Defaults to false. Hides the post. |
pinned |
boolean | No | Pins the post to the top of the blog list |
toc |
boolean | No | Generate a table of content. |
WARNING
Posts missing any required field are automatically excluded from the blog list.
Field guidelines
1. Date format
Always use ISO 8601 format: YYYY-MM-DD
date: "2025-02-27" Correct
date: "02/27/2025" Wrong
date: "Feb 27,2025" WrongWARNING
Invalid date formats will prevent proper sorting and display.
2. Categories
Categories are automatically normalized to uppercase for consistency:
technology→TECHNOLOGYEducation→EDUCATIONweb dev→WEB DEV
Categories appear as:
- Filter tags on the main blog page
- Breadcrumb navigation on individual posts
- Labels on post cards
Categories must:
- Use descriptive, broad categories
- Stick to 1-2 words when possible
- Be consistent across posts
- Maintain 4–8 main categories to avoid clutter
Common categories include: TECHNOLOGY, DESIGN, TUTORIAL, NEWS, EDUCATION
3. Draft handling
Posts with isDraft: true are hidden in production builds but still visible locally during development.
Use this to preview or refine posts before publishing.