Back to Content

page-break-after

files/en-us/web/css/reference/properties/page-break-after/index.md

latest3.7 KB
Original Source

{{deprecated_header}}

[!WARNING] This property has been replaced by the {{cssxref("break-after")}} property.

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

{{InteractiveExample("CSS Demo: page-break-after")}}

css
page-break-after: auto;
css
page-break-after: always;
html
<div>
  <p>
    The effect of this property can be noticed when the document is being
    printed or a preview of a print is displayed.
  </p>
  <button id="print-btn">Show Print Preview</button>
  <div class="box-container">
    <div class="box">Content before the property</div>
    <div class="box" id="example-element">Content with 'page-break-after'</div>
    <div class="box">Content after the property</div>
  </div>
</div>
css
.box {
  border: solid #5b6dcd 5px;
  background-color: #5b6dcd;
  margin: 10px 0;
  padding: 5px;
}

#example-element {
  border: solid 5px #ffc129;
  background-color: #ffc129;
  color: black;
}
js
const btn = document.getElementById("print-btn");

btn.addEventListener("click", () => {
  window.print();
});

Syntax

css
/* Keyword values */
page-break-after: auto;
page-break-after: always;
page-break-after: avoid;
page-break-after: left;
page-break-after: right;
page-break-after: recto;
page-break-after: verso;

/* Global values */
page-break-after: inherit;
page-break-after: initial;
page-break-after: revert;
page-break-after: revert-layer;
page-break-after: unset;

This property applies to block elements that generate a box. It won't apply on an empty {{HTMLElement("div")}} that won't generate a box.

Values

  • auto
    • : Initial value. Automatic page breaks (neither forced nor forbidden).
  • always
    • : Always force page breaks after the element.
  • avoid
    • : Avoid page breaks after the element.
  • left
    • : Force page breaks after the element so that the next page is formatted as a left page. It's the page placed on the left side of the spine of the book or the back side of the page in duplex printing.
  • right
    • : Force page breaks after the element so that the next page is formatted as a right page. It's the page placed on the right side of the spine of the book or the front side of the page in duplex printing.
  • recto
    • : If pages progress left-to-right, then this acts like right. If pages progress right-to-left, then this acts like left.
  • verso
    • : If pages progress left-to-right, then this acts like left. If pages progress right-to-left, then this acts like right.

Page break aliases

The page-break-after property is now a legacy property, replaced by {{cssxref("break-after")}}.

For compatibility reasons, page-break-after should be treated by browsers as an alias of break-after. This ensures that sites using page-break-after continue to work as designed. A subset of values should be aliased as follows:

page-break-afterbreak-after
autoauto
leftleft
rightright
avoidavoid
alwayspage

Formal definition

{{cssinfo}}

Formal syntax

{{csssyntax}}

Examples

Setting a page break after footnotes

css
/* move to a new page after footnotes */
div.footnotes {
  page-break-after: always;
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{cssxref("break-before")}}, {{cssxref("break-after")}}, {{cssxref("break-inside")}}
  • {{cssxref("page-break-before")}}, {{cssxref("page-break-inside")}}
  • {{cssxref("orphans")}}, {{cssxref("widows")}}