CSS page-break-before Property

CSS Reference Complete CSS Reference

Example

Set the page-breaking behavior to always break before an h1 element:

<html>
<head>
<style>
@media print
{
h1 {page-break-before:always}
}
</style>
</head>

<body>
....
</body>
</html>

Definition and Usage

The page-break-before property sets the page-breaking behavior before an element.

Note: You cannot use this property on absolutely positioned elements.

Note: Use the page-breaking properties as few times as possible and avoid page-breaking properties inside tables, floating elements, and block elements with borders.

Default value: auto
Inherited: no
Version: CSS2
JavaScript syntax: object.style.pageBreakBefore="always"

Browser Support

Internet Explorer Firefox Opera Google Chrome Safari

The page-break-before property is supported in all major browsers.

Note: No versions of Internet Explorer (including IE8) support the property values "left", "right", or "inherit".

Note: Firefox, Chrome, and Safari do not support the property values "avoid", "left", or "right".

Property Values

Value Description
auto Default. Insert a page break before the element if necessary
always Insert a page break before the element
avoid Avoid inserting a page break before the element
left Insert page breaks before the element until it reaches a blank left page
right Insert page breaks before the element until it reaches a blank right page
inherit Specifies that the value of the page-break-before property should be inherited from the parent element

Related Pages

HTML DOM reference: pageBreakBefore property

CSS Print Reference Complete CSS Print Reference