Copy page

Writing

Frontmatter

Frontmatter is metadata written in YAML format at the beginning of markdown files, enclosed between triple dashes (---). It allows you to configure various aspects of your pages without affecting the visible content.

In APIToGo, frontmatter enables you to customize page titles, descriptions, navigation settings, and other document properties. Here are all the supported properties:

Properties

title

Sets the page title that appears in the browser tab and as the document title.

Code
---
title: My Page Title
---

description

Provides a description for the page, which can be used for SEO and content summaries.

Code
---
description: This page explains how to use APIToGo's markdown features.
---

category

Assigns the page to a specific category for organizational purposes. This will be shown above the main heading of the document.

Code
---
category: Getting Started
---

navigation_label

Deprecated (sidebar_label)

Sets a custom label for the page in the sidebar navigation, allowing you to use a shorter or different title than the main page title.

Code
---
title: My Very Long Documentation Page Title
navigation_label: Short Title
---

navigation_icon

Deprecated (sidebar_icon)

Specifies a Lucide icon to display next to the page in the sidebar navigation.

Code
---
navigation_icon: compass
---

navigation_display

Specifies the display property of the navigation item. See the Navigation guide

Code
---
navigation_display: auth
---

toc

Controls whether the table of contents is displayed for the page. Set to false to hide the table of contents.

Code
---
toc: false
---

disable_pager

Controls whether the previous/next page navigation is displayed at the bottom of the page. Set to true to disable it.

Code
---
disable_pager: true
---

draft

Marks a document as a draft. Draft documents are only visible when running in development mode and are excluded from production builds. This is useful for working on content that isn't ready to be published.

Code
---
draft: true
---

lastModifiedTime

The last modified timestamp for the page. This property is automatically set by APIToGo during the build process based on the Git commit history. You generally should not set this manually.

If you need to override the automatically detected date, you can set it explicitly:

Code
---
lastModifiedTime: 2025-11-20T10:30:00.000Z
---

Complete Example

Here's an example showing multiple frontmatter properties used together:

documentation.md
---
title: Advanced Configuration Guide
description: Learn how to configure advanced features in APIToGo
category: Configuration
navigation_label: Advanced Config
navigation_icon: settings
toc: true
disable_pager: false
draft: false
---

This page content follows the frontmatter...