Frontmatter #

title #

Human-readable page title. When omitted, Glaze infers a title from the slug (e.g. my-post becomes My Post).

---
title: Getting started with Glaze
---

slug #

Overrides the URL path derived from the file path. Useful for custom routes like / for the home page.

---
slug: /
---

Slug values are normalized (lowercased and slugified).

date #

Publish date or datetime. Must be a value parseable as a date or datetime.

---
date: 2026-02-24
---

---
date: 2026-02-24T14:30:00+01:00
---

Glaze normalizes date to a Cake\Chronos\Chronos instance. If the value cannot be parsed, content discovery throws an exception.

In templates:

<?php $date = $page->meta['date'] ?? null; ?>

<?php if ($date instanceof \Cake\Chronos\Chronos): ?>
    <time datetime="<?= $date->toIso8601String() ?>">
        <?= $date->format('F j, Y') ?>
    </time>
<?php endif; ?>

weight #

Integer sort order for page collections. Lower values sort first. Useful for controlling navigation menus, ordered documentation sections, or any list where file-path ordering is not sufficient.

---
weight: 10
---

In templates, sort a collection by weight:

<li s:foreach="$this->pages()->by('meta.weight', 'asc') as $p">
    <a href="<?= $p->urlPath ?>"><?= $p->title ?></a>
</li>

Navigation-focused usage of weight, section, navigation, and navigationTitle is covered in Templating and Page Collections.

draft #

Marks the page as a draft. Draft pages are excluded from glaze build output unless --drafts is passed. The live server (glaze serve) includes drafts by default.

---
draft: true
---

type #

Explicitly assigns a content type when contentTypes are configured in glaze.neon. Normally the type is resolved automatically from the file path. Use this to override:

---
type: blog
---

template #

Overrides the default page template for this page. The value is a template name (without .sugar.php extension) relative to templates/.

---
template: landing
---

This causes the page to render with templates/landing.sugar.php instead of the configured default.

Taxonomy fields #

Any key listed under taxonomies in glaze.neon is extracted as a taxonomy. Values can be a single string or a NEON list.

---
tags:
  - php
  - static-sites
categories:
  - tutorials
---

Custom fields #

Use any non-reserved key for custom page data. Nested maps/lists are preserved and can be read with dotted access in templates.

---
hero:
  title: Build fast static sites
  primaryAction:
    label: Read docs
    href: /installation
---

In templates:

<?= $page->meta('hero.title') ?>
<?= $page->meta('hero.primaryAction.href') ?>

meta can still be used as a key if you want, but it is no longer required as a wrapper for nested data.