# Page options

Add the following annotations at the beggining of `.rst` files to customize the layout of a specific page.

## Description

Adds a description to a document.
This description displayed in search engines results page.

For example:

```none
.. meta::
   :description: The reStructuredText plaintext markup language
   :keywords: plaintext, markup language
```

Results in the following HTML:

```html
<meta name="description"
   content="The reStructuredText plaintext markup language">
<meta name="keywords" content="plaintext, markup language">
```

## Full width

If set, makes the content full-width.

```none
:full-width:
```

## Landing page

If set, makes the content within the div with class `landing_content` float on top of the hero box.

```none
:landing:
```

## Hide pre content

If set, hides the breadcrumbs from the page.

```none
:hide-pre-content:
```

## Hide post content

If set, hides the prev / next navigation buttons from the page.

```none
:hide-post-content:
```

## Hide sidebar

If set, hides the primary sidebar from the page.

```none
:hide-sidebar:
```

## Hide secondary sidebar

If set, hides the secondary sidebar from the page.

```none
:hide-secondary-sidebar:
```

## TOC depth

Sets the depth of the table of contents in the secondary sidebar (“On This Page”).

Valid values are 2, 3, or 4. Default is 2.

```none
:toc-depth: 3
```

## Hide version warning

If set, hides the version warning from the page.

```none
:hide-version-warning:
```

## Exclude doctools

Excludes `doctools.js` from specific documentation pages.

Required to make the toolchain compatible with Swagger UI.

```none
:exclude-doctools:
```
