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

# Page breaks in DOCX export

Learn about page break support when exporting Tiptap editor content to DOCX 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 DOCX export extension, these page breaks are included in the exported document.

## How it works

- `pageBreak` nodes in the editor are converted to `<w:br w:type="page"/>` in the DOCX output
- This produces a standard Word page break that starts a new page
- No extra configuration is needed; if the PageBreak extension is registered, export works automatically

## Setting up PageBreak with DOCX export

Register the PageBreak extension alongside the DOCX 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 { ExportDocx } from '@tiptap-pro/extension-export-docx'
import { PageBreak } from '@tiptap-pro/extension-pagebreak'

const editor = new Editor({
  extensions: [
    ConvertKit,
    PageBreak,
    ExportDocx.configure({
      onCompleteExport: (result) => {
        const blob = new Blob([result], {
          type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
        })
        const url = URL.createObjectURL(blob)
        const a = document.createElement('a')
        a.href = url
        a.download = 'export.docx'
        a.click()
        URL.revokeObjectURL(url)
      },
    }),
  ],
})
```

## Standalone usage

For custom export pipelines or server-side usage, you can use the `convertPageBreak` function directly:

```js
import { convertPageBreak } from '@tiptap-pro/extension-export-docx'
```

This function converts a `pageBreak` node into the corresponding DOCX paragraph with a page break element, and can be used when building custom node conversion pipelines.

## 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
- [DOCX export guide](https://tiptap.dev/docs/conversion/export/docx/editor-extension.md) for general export setup