# `cloud_sptheme.ext.page_only` – Exclude Pages from Build

Added in version 1.8.

## Overview

This extension provides a `.. page-only::` directive, which allows conditionally omitting entire pages from the document based on build tags.

The first line of a page should be a `.. page-only:: <expr>` directive; where `<expr>` is a tag, or simple tag expression, just like `.. only::`. If the expression evaluates to False, the page won’t be included in the final build (and should be silently omitted from any TOC lists).

E.g. `.. page-only:: draft and html`