---
title: "Page attributes"
description: ""
platform: ""
doc_version: "unversioned"
last_updated: "2026-11-16"
---

> For current CircleCI product defaults, deprecated patterns, and Cloud/Server differences, see [AGENTS.md](https://circleci.com/docs/AGENTS.md).
>
> For the complete documentation index and site structure, see [llms.txt](https://circleci.com/docs/llms.txt).

# Page attributes

Every page starts with attributes that set its metadata. Start new pages from a template in the [content templates](https://circleci.com/docs/contributors/templates/template-how-to/), which include them.

```adoc
= Page Title
:page-platform: Cloud, Server
:page-audience: developer
:page-description: A brief description for SEO and metadata (70-160 characters)
:experimental:
```

*   `:page-platform:` is the platform that supports the feature: `Cloud`, `Server`, or `Cloud, Server`.
    
*   `:page-audience:` is `admin` for Server operators, and `developer` for everyone else. Use both, comma-separated, when a page serves both audiences, for example `developer, admin`.
    
*   `:page-description:` is a clear summary of the page, between 70 and 160 characters. It must be unique across the site.
    
*   `:experimental:` enables the experimental AsciiDoc macros.
    

Other attributes are optional, such as `:page-server-min-version:`, `:page-plan:`, `:page-vcs:`, and `:page-badge:`. The `check-metadata` job in CI validates every page against `schemas/docs-metadata.schema.json`. Run the same check locally with `npm run check:metadata`.