page-break-before (CSS property)

Spec
Inherited Initial Version
No auto CSS2
Browser support (more…)
IE8+ FF1+ SA1.3+ OP9.2+ CH2+
Full Partial Partial Full Partial

Syntax

page-break-before: { always | auto | avoid | left | right | inherit } ;

Description

This property specifies whether a page break may, must, or shouldn’t occur before a block-level element’s generated box.

Example

This style rule makes every h2 element start at the top of a new page:

h2 {
  page-break-before: always;
}

Value

always
forces a page break before the box
auto
allows a page break before the box, but doesn’t require it
avoid
tells the user agent to avoid inserting a page break before the box, if at all possible
left
forces one or two page breaks before the box, so that the next page will be a left-hand page
right
forces one or two page breaks before the box, so that the next page will be a right-hand page

Compatibility

Internet Explorer Firefox Safari Opera Chrome
5.5 6.0 7.0 8.0 1.0 1.5 2.0 3.0 3.5 1.3 2.0 3.1 4.0 9.2 9.5 10.0 2.0
Partial Partial Partial Full Partial Partial Partial Partial Partial Partial Partial Partial Partial Full Full Full Partial

Internet Explorer for Windows versions up to and including 8 do not support the values left and right; either value is interpreted as the value always.

Internet Explorer for Windows versions up to and including 7 do not support the value avoid.

Internet Explorer for Windows versions up to and including 7 don’t support the value inherit.

Firefox versions up to and including 3.5 don’t support the avoid, left, or right values.

Safari versions up to and including 4 (and Chrome versions up to and including 3) don’t support the avoid, left, or right values.

User-contributed notes

Related Products