page-break-before property CSS Reference



Definition and Usage

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

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

Note: this property is in progress of being replaced by the more generic break-before. This new property also handles column and region breaks and is syntactically compatible with page-break-before.

Before using page-break-before, check if you can use break-before instead. In the future page-break-before will be a mere alias for some values of it.

  • Initial auto
  • Applies to block-level elements in the normal flow of the root element. UA may also apply it to other elements like table-row elements.
  • Inherited no
  • Media visual, paged
  • Computed Value as specified
  • Animatable no
  • Canonical order the unique non-ambiguous order defined by the formal grammar

Syntax

Formal syntax: auto | always | avoid | left | right
page-break-before: auto
page-break-before: always
page-break-before: avoid
page-break-before: left
page-break-before: right
page-break-before: inherit

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.
right
Force page breaks before the element so that the next page is formatted as a right page.

Examples

/* avoid page break before the div */
div.note {
    page-break-before: avoid;
}

Compatibility

Desktop browsers

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (auto, always) 1.0 1.0 (1.7 or earlier) 4.0 7.0 1.2 (125)
avoid, left, right 1.0 Not supported (bug 132035) 4.0 7.0 1.2 (125)

Mobile browsers

Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support NA 1.0 (1.0) NA NA NA
avoid, left, right NA Not supported (bug 132035) NA NA NA

Relative articles