Publishing and Privacy

April 16, 2026 · 1 min read

Contents

Publishing a note
Private notes
Private page placeholder
Homepage and listing files
Unlisted root-level notes
Aliases
See also

OnyxFolio gives you fine-grained control over which notes appear on the public web. The opt-in model means everything is private by default.

Publishing a note

Add website: true to any note's frontmatter to publish it:

---
website: true
title: My Post
date: 2026-04-16
---

Without this field (or with website: false), the note is not accessible as a web page.

Private notes

A note without website: true is private:

It does not appear on listing pages or search results.
Its URL returns a "this note is private" placeholder page (not a 404).
It is fully accessible to Dataview queries — you can reference private notes in tables and lists.
It can be transcluded into published notes using ![[Note Title]].
Its tags are collected and usable in Dataview FROM #tag queries.

This makes private notes useful as: - Drafts (visible in Dataview listings but not published) - Metadata records (referenced by other notes) - Data sources for dynamic tables

Private page placeholder

When a visitor navigates to a private note's URL, OnyxFolio renders a private.html template instead of a 404. The page shows the note title and a back link to the parent section. This prevents broken wiki-links when you reference a private note from a published one.

Homepage and listing files

Notes with type: homepage or type: listing are registered in SECTION_ROUTES and do not appear in ALL_POSTS. They are never listed in section listings or search results — they serve as the section root page only.

Unlisted root-level notes

Notes in the vault root (no subfolder) that do not have type: homepage or type: listing are served at /<slug> with no section prefix. They do not appear in any auto-generated listing.

The intended way to surface them: - Link to them via [[wiki-links]] from other content - Pin them to the nav via menu_order

Aliases

Published notes can register alternate link names via the aliases frontmatter field. All aliases resolve to the same URL — useful when a note is known by multiple names across your vault.

aliases:
  - quick reference
  - cheat sheet