Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / CSS

break-before — fragmentation before an element

`break-before` controls breaks before an element's box when content flows across pages, columns, or regions. It can force a break or discourage one; it does not control text wrapping into lines.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

break-before: auto | avoid | always | all | avoid-page | page | left | right | recto | verso | avoid-column | column | avoid-region | region;
/* Also accepts CSS-wide keywords. */

break-before controls the boundary before a generated box in fragmented layout. Its initial value is auto, and it is not inherited. auto neither forces nor forbids a break; avoid discourages one. A forced break overrides avoidance restrictions, and those restrictions may be relaxed when content cannot fit.

page forces a new page, while column forces a new column; avoid-page and avoid-column discourage the corresponding break. Values only affect their relevant context. left and right select a left or right page; recto and verso select respectively the second or first page of a spread according to page progression. This can require a blank page.

In the Level 4 draft, always forces a break in the immediately containing fragmentation context, whereas all breaks through every containing context. region and avoid-region concern CSS Regions chains. A value's presence in a specification does not establish browser support; check the target implementation before use.

page-break-before is a legacy compatibility alias for break-before: auto, left, right, and avoid map to identical break-before values, but always maps to page, not always. Breaking before an element does not prevent breaks inside it — use break-inside for that.

Examples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>break-before</title>
<style>
  .columns {
    width: 420px;
    height: 120px;
    column-count: 2;
    column-gap: 20px;
    column-fill: auto;
    direction: ltr;
    writing-mode: horizontal-tb;
    font: 16px/24px monospace;
  }
  p { margin: 0; }
  .next { break-before: column; }
</style>
<div class="columns">
  <p>A</p>
  <p class="next">B</p>
</div>
</html>

Result

Expected layout: A at the top of the first column; B at the top of the second column, 220 CSS px to the right of A.

The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.

Sources