---
title: "Page breaks in PDF export"
description: "Learn about page break support when exporting Tiptap editor content to PDF files."
canonical_url: "https://tiptap.dev/docs/conversion/export/pdf/page-breaks"
---

# Page breaks in PDF export

Learn about page break support when exporting Tiptap editor content to PDF files.

- **1. Activate trial or subscribe**

  Start a [free trial](https://cloud.tiptap.dev/v2?trial=true) or [subscribe to the Start plan](https://cloud.tiptap.dev/v2/billing) in your account.
- **2. Install from private registry**

  To install this frontend extensions, authenticate to Tiptap's private npm registry by following the [setup guide](https://tiptap.dev/docs/guides/pro-extensions.md).

The [PageBreak extension](https://tiptap.dev/docs/pages/core-concepts/page-break-node.md) lets users insert explicit page breaks in the editor. When combined with the PDF export extension, these page breaks are included in the exported document.

## How it works

Page breaks are fully supported in PDF export. The PDF export uses DOCX conversion under the hood, where `pageBreak` nodes are converted to `<w:br w:type="page"/>`, producing standard page breaks in the resulting PDF.

## Setting up PageBreak with PDF export

Register the PageBreak extension alongside the PDF export extension. Page breaks in your editor content will be automatically converted when exporting.

```ts
import { Editor } from '@tiptap/core'
import { ConvertKit } from '@tiptap-pro/extension-convert-kit'
import { ExportPdf } from '@tiptap-pro/extension-export-pdf'
import { PageBreak } from '@tiptap-pro/extension-pagebreak'

const editor = new Editor({
  extensions: [
    ConvertKit,
    PageBreak,
    ExportPdf.configure({
      token: 'your-jwt',
      onCompleteExport: (result) => {
        const blob = new Blob([result], { type: 'application/pdf' })
        const url = URL.createObjectURL(blob)
        const a = document.createElement('a')
        a.href = url
        a.download = 'export.pdf'
        a.click()
        URL.revokeObjectURL(url)
      },
    }),
  ],
})
```

## Learn more

- [PageBreak extension reference](https://tiptap.dev/docs/pages/core-concepts/page-break-node.md) for full options, commands, and keyboard shortcuts
- [Page breaks in DOCX import](https://tiptap.dev/docs/conversion/import/docx/page-breaks.md) for import support
- [PDF export guide](https://tiptap.dev/docs/conversion/export/pdf/editor-extension.md) for general export setup