From aa5fc42a821696ca99ecd6830b0e5af46476bfe3 Mon Sep 17 00:00:00 2001
From: Gio <sethg@ipi.org>
Date: Fri, 16 Apr 2021 20:47:27 -0500
Subject: [PATCH] Documentation

---
 docs/content.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/content.rst b/docs/content.rst
index 48c851ab..010d000f 100644
--- a/docs/content.rst
+++ b/docs/content.rst
@@ -614,6 +614,14 @@ the ``DEFAULT_METADATA``::
 To publish a post when the default status is ``draft``, update the post's
 metadata to include ``Status: published``.
 
+Hidden posts
+=================
+
+Like pages, posts can also be marked as ``hidden`` with the ``Status: hidden``
+attribute. Hidden posts will be output to the final path as expected, but
+are not included by default in tag or category indexes, nor in the main
+article feed. This has the effect of creating an "unlisted" post.
+
 .. _W3C ISO 8601: https://www.w3.org/TR/NOTE-datetime
 .. _AsciiDoc: https://www.methods.co.nz/asciidoc/
 .. _pelican-plugins: https://github.com/getpelican/pelican-plugins