---
title: "Page Break plugin"
description: "Add a page break."
canonical_url: "https://www.tiny.cloud/docs/tinymce/latest/pagebreak/"
md_url: "https://www.tiny.cloud/docs/tinymce/6/pagebreak/index.md"
version: "6"
last_updated: "2022-11-30T01:26:11Z"
tokens: 683
---
Important This page documents TinyMCE 6. For new projects, Tiny recommends using the latest, most up-to-date version. [See TinyMCE 8 documentation](../../latest/pagebreak/).
# Page Break plugin

This plugin adds page break support and enables a user to insert page breaks in the editable area. This is useful where a CMS uses a special separator to break content into pages.

It also adds a toolbar button and a menu item `Page break` under the `Insert` menu dropdown.

## Basic setup

```js
tinymce.init({
  selector: 'textarea',  // change this value according to your html
  plugins: 'pagebreak',
  toolbar: 'pagebreak'
});
```

## Options

These settings affect the execution of the `pagebreak` plugin. They enable you to specify how the page break should be generated in the HTML source code and determine whether the page break element(s) should be wrapped in `<p>` tags.

### `pagebreak_separator`

**Type:** `String`

**Default value:** `'<!-- pagebreak -->'`

#### Example: using `pagebreak_separator`

```js
tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  plugins: 'pagebreak',
  toolbar: 'pagebreak',
  pagebreak_separator: '<!-- my page break -->'
});
```

### `pagebreak_split_block`

When enabled this option makes it easier to split block elements with a page break.

**Type:** `Boolean`

**Default value:** `false`

**Possible values:** `true`, `false`

#### Example: using `pagebreak_split_block`

```js
tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  plugins: 'pagebreak',
  toolbar: 'pagebreak',
  pagebreak_split_block: true
});
```

## Toolbar buttons

The Page Break plugin provides the following toolbar buttons:

| Toolbar button identifier | Description |
| --- | --- |
| `pagebreak` | Inserts a pagebreak into the editor. |

These toolbar buttons can be added to the editor using:

- The [`toolbar`](../toolbar-configuration-options/#toolbar) configuration option.
- The [`quickbars_insert_toolbar`](../quickbars/#quickbars_insert_toolbar) configuration option.
- [Custom Context toolbars](../contexttoolbar/).

## Menu items

The Page Break plugin provides the following menu items:

| Menu item identifier | [Default Menu Location](../menus-configuration-options/#example-the-tinymce-default-menu-items) | Description |
| --- | --- | --- |
| `pagebreak` | Insert | Inserts a pagebreak into the editor. |

These menu items can be added to the editor using:

- The [`menu`](../menus-configuration-options/#menu) configuration option.
- The [`contextmenu`](../menus-configuration-options/#contextmenu) configuration option.
- [Custom Menu toolbar buttons](../custom-menu-toolbar-button/).

## Commands

The Page Break plugin provides the following TinyMCE command.

| Command | Description |
| --- | --- |
| mcePageBreak | Inserts a virtual page break (`<!-- pagebreak -->`) at the cursor location or overwrites the current selection. |

Example
```js
tinymce.activeEditor.execCommand('mcePageBreak');
```