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

# Page breaks in EPUB export

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

## How it works

Page breaks are fully supported in EPUB export. The EPUB 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 EPUB file.

## Setting up PageBreak with EPUB export

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

const editor = new Editor({
  extensions: [
    ConvertKit,
    PageBreak,
    ExportEpub.configure({
      token: 'your-jwt',
      onCompleteExport: (result) => {
        const blob = new Blob([result], { type: 'application/epub+zip' })
        const url = URL.createObjectURL(blob)
        const a = document.createElement('a')
        a.href = url
        a.download = 'export.epub'
        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
- [EPUB export guide](https://tiptap.dev/docs/conversion/export/epub/editor-extension.md) for general export setup