W3cubDocs

page-break-before

Warning: This property has been replaced by the break-before property.

The page-break-before CSS property adjusts page breaks before the current element.

This property applies to block elements that generate a box. It won't apply on an empty <div> that won't generate a box.

/* Keyword values */
page-break-before: auto;
page-break-before: always;
page-break-before: avoid;
page-break-before: left;
page-break-before: right;
page-break-before: recto;
page-break-before: verso;

/* Global values */
page-break-before: inherit;
page-break-before: initial;
page-break-before: revert;
page-break-before: revert-layer;
page-break-before: unset;

Syntax

Values

auto: Initial value. Automatic page breaks (neither forced nor forbidden).
always: Always force page breaks before the element.
avoid: Avoid page breaks before the element.
left: Force page breaks before the element so that the next page is formatted as a left page. It's the page placed on the left side of the spine of the book or the back side of the page in duplex printing.
right: Force page breaks before the element so that the next page is formatted as a right page. It's the page placed on the right side of the spine of the book or the front side of the page in duplex printing.
recto Experimental: If pages progress left-to-right, then this acts like right. If pages progress right-to-left, then this acts like left.
verso Experimental: If pages progress left-to-right, then this acts like left. If pages progress right-to-left, then this acts like right.

Page break aliases

The page-break-before property is now a legacy property, replaced by break-before.

For compatibility reasons, page-break-before should be treated by browsers as an alias of break-before. This ensures that sites using page-break-before continue to work as designed. A subset of values should be aliased as follows:

page-break-before	break-before
`auto`	`auto`
`left`	`left`
`right`	`right`
`avoid`	`avoid`
`always`	`page`

Formal definition

Initial value	`auto`
Applies to	block-level elements in the normal flow of the root element. User agents may also apply it to other elements like `table-row` elements.
Inherited	no
Computed value	as specified
Animation type	discrete

Formal syntax

page-break-before = 
  auto     |
  always   |
  avoid    |
  left     |
  right    |
  inherit

Examples

Avoid a page break before an element

/* avoid page break before div elements of class note */
div.note {
    page-break-before: avoid;
}

Specifications

Specification
CSS Logical Properties and Values Level 1 # page
Proposals for the future of CSS Paged Media # page-break-before

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`page-break-before`	1	12	1 The values `avoid`, `left`, and `right` are unsupported.	4	7	1.2	37	18	4 The values `avoid`, `left`, and `right` are unsupported.	14	1	1.0