This property has been replaced by the
break-inside
property.The page-break-inside
CSS property adjusts page breaks inside the current element.
/* Keyword values */ page-break-inside: auto; page-break-inside: avoid; /* Global values */ page-break-inside: inherit; page-break-inside: initial; page-break-inside: unset;
Syntax
Values
auto
- Initial value. Automatic page breaks (neither forced nor forbidden).
avoid
- Avoid page breaks inside the element.
Page break aliases
The page-break-inside
property is now a legacy property, replaced by break-inside
.
For compatibility reasons, page-break-inside
should be treated by browsers as an alias of break-inside
. This ensures that sites using page-break-inside
continue to work as designed. A subset of values should be aliased as follows:
page-break-inside | break-inside |
---|---|
auto |
auto |
avoid |
avoid |
Formal definition
Initial value | auto |
---|---|
Applies to | block-level elements in the normal flow of the root element. User agents may also apply it to other elements like table-row elements. |
Inherited | no |
Computed value | as specified |
Animation type | discrete |
Formal syntax
auto | avoid
Examples
Avoiding page breaks inside elements
HTML
<div class="page"> <p>This is the first paragraph.</p> <section class="list"> <span>A list</span> <ol> <li>one</li> <!-- <li>two</li> --> </ol> </section> <ul> <li>one</li> <!-- <li>two</li> --> </ul> <p>This is the second paragraph.</p> <p>This is the third paragraph, it contains more text.</p> <p>This is the fourth paragraph. It has a little bit more text than the third one.</p> </div>
CSS
.page { background-color: #8cffa0; height: 90px; width: 200px; columns: 1; column-width: 100px; } .list, ol, ul, p { break-inside: avoid; } p { background-color: #8ca0ff; } ol, ul, .list { margin: 0.5em 0; display: block; background-color: orange; } p:first-child { margin-top: 0; }
Result
Specifications
Specification | Status | Comment |
---|---|---|
CSS Paged Media Module Level 3 The definition of 'page-break-inside' in that specification. |
Working Draft | Allows this property on more elements. |
CSS Level 2 (Revision 1) The definition of 'page-break-inside' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
page-break-inside | Chrome Full support 1 | Edge Full support 12 | Firefox
Full support
19
| IE Full support 8 | Opera Full support 7 | Safari Full support 1.3 | WebView Android Full support 37 | Chrome Android Full support 18 | Firefox Android
Full support
19
| Opera Android Full support 14 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 |
Legend
- Full support
- Full support
- See implementation notes.
- See implementation notes.