page-break-inside (CSS property)

Spec
Inherited Initial Version
Yes auto CSS2
Browser support (more…)
IE8+ FF3.5 SA4 OP9.2+ CH2
Buggy None None Full None

Syntax

page-break-inside: { auto | avoid | inherit } ;

Description

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

Example

This style rule tells the user agent to avoid splitting unordered lists over two pages:

ul {
  page-break-inside: avoid;
}

Value

auto
allows a page break inside the box
avoid
tells the user agent to avoid inserting a page break inside the box, if at all possible

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
None None None Buggy None None None None None None None None None Full Full Full None

Internet Explorer for Windows versions up to and including 7 don’t support this property.

Although Internet Explorer for Windows version 8 supports the value avoid it is a little buggy in places. For example, if applied to a p element, the browser will try to avoid breaking the page inside the element as expected; but if applied to a ul element, the whole list is not set to avoid as the list may span the two pages. That said, the individual list element will try to avoid having a page break inside.

Firefox versions up to and including 3.5 don’t support this property.

Safari versions up to and including 4 and Chrome versions up to and including 3 don’t support this property.

User-contributed notes

Related Products