# Print support

> Configure printable pages and whole-section print output.

---

LLMS index: [llms.txt](/llms.txt)

---

Individual documentation pages print well from most browsers as the layouts have
been styled to omit navigational chrome from the printed output.

On some sites, it can be useful to enable a "print entire section" feature (as
seen in this user guide). Selecting this option renders the entire current
top-level section (such as Advanced for this page) with all of its child pages
and sections in a format suited to printing, complete with a table of contents
for the section.

To enable this feature, add the "print" output format in your site's
`hugo.toml`/`hugo.yaml`/`hugo.json` file for the "section" type:

<!-- markdownlint-disable no-shortcut-ref-link -->
<!-- prettier-ignore-start -->
**Configuration file:**

```

```

**hugo.toml**

```toml
[outputs]
section = [ "HTML", "RSS", "print" ]
```

**hugo.yaml**

```yaml
outputs:
  section:
    - HTML
    - RSS
    - print
```

**hugo.json**

```json
{
  "outputs": {
    "section": [
      "HTML",
      "RSS",
      "print"
    ]
  }
}
```
<!-- prettier-ignore-end -->
<!-- markdownlint-enable no-shortcut-ref-link -->

The site should then show a "Print entire section" link in the right hand
navigation.

## Further Customization

### Disabling the ToC

To disable showing the table of contents in the printable view, set the
`disable_toc` param to `true`, either in the page front matter, or in
`hugo.toml`/`hugo.yaml`/`hugo.json`:

<!-- markdownlint-disable -->
<!-- prettier-ignore-start -->
**Front matter:**

```Front matter:

```

**toml**

```toml
+++
…
disable_toc = true
…
+++
```

**yaml**

```yaml
---
…
disable_toc: true
…
---
```

**json**

```json
{
  …,
  "disable_toc": true,
  …
}
```
<!-- prettier-ignore-end -->

<!-- prettier-ignore-start -->
**Config file:**

```

```

**hugo.toml**

```toml
[params.print]
disable_toc = true
```

**hugo.yaml**

```yaml
params:
  print:
    disable_toc: true
```

**hugo.json**

```json
{
  "params": {
    "print": {
      "disable_toc": true
    }
  }
}
```
<!-- prettier-ignore-end -->
<!-- markdownlint-restore -->

## Layout hooks

A number of layout partials and hooks are defined that can be used to customize
the printed format. These can be found in `layouts/_partials/print`.

Hooks can be defined on a per-type basis. For example, you may want to customize
the layouts of heading for "blog" pages vs "docs". This can be achieved by
creating `layouts/_partials/print/page-heading-<type>.html` such as
`page-heading-blog.html`. It defaults to using the page title and description as
a heading.

Similarly, the formatting for each page can be customized by creating
`layouts/_partials/print/content-<type>.html`.