Skip to content
Skip the list of specifications

page-break-before

same effect as Chrome: 2 of 2 decided examples match Chrome; 1 where Chrome departs from the specification

css2

The declaration changes our page the way it changes Chrome’s. What still differs between the two renderings was there before the declaration too, on the same page without it (mostly the fonts): no larger with it, or in the same places and no stronger.

What the specification says

Initial valueauto
Applies toblock-level elements (but see text)
Inheritedno
PercentagesN/A
Computed valueas specified
Syntaxauto | always | avoid | left | right | inherit

The definition in css2

The measurements

3 examples: two match Chrome and one differs where Chrome departs from the specification. Each is one declaration on a small page, drawn by Chrome and by our engine. Drag on a picture to move the line between them.

page-break-before:right

Chrome departs from the specification

A dot marks a page that differs where Chrome departs from the specification.

Chrome rendering
Ours rendering
Left of the line is ours, right of it Chrome’s rendering. Drag on the picture to move the line.
Pixels that differ from Chrome36,946
The same, on the page without the declaration16,849
Largest difference on one colour channel255 of 255
The same, on the page without the declaration255 of 255
Pages, ours and Chrome’s5 and 4

Chrome breaks once and puts the block on page 2, a left page; ours leaves page 2 blank and starts the block on page 3, a right page. page-break-before: right is an alias of break-before: right (css-break-3 §3.4). css-break-3 §3.1 (and css-break-4 §3.1, in the same words) requires one or two breaks “so that the next page is formatted as a right page”; in a left-to-right document the first page is a right page (css-page-3 §3.3). Leaving page 2 out, the pages differ by 16,006 pixels, against 16,849 on the page without the declaration.

The example’s page

page-break-before:always, page-break-before:left

same effect as Chrome
Chrome rendering
Ours rendering
Left of the line is ours, right of it Chrome’s rendering. Drag on the picture to move the line.
Pixels that differ from Chrome16,006
The same, on the page without the declaration16,849
Largest difference on one colour channel255 of 255
The same, on the page without the declaration255 of 255
Pages, ours and Chrome’s4 and 4

The pages differ by 16,006 pixels with the declaration and by 16,849 without it: what differs is there before the property (mostly the fonts), and the declaration does not add to it.

The example’s page

Which values were measured

A match on one example means a match at the value tried. The property’s grammar has 6 branches, and 3 of them carry a measurement.

ValueMeasured
always
same effect as Chrome
avoidnot measured
left
same effect as Chrome
right
Chrome departs from the specification
autonot measured
inheritnot measured

Measured against Chrome 148.0.7778.96 on 5 November 2026, with up to 40 candidate values tried per property. How it was measured