CKTIS / CSS
break-inside — controlling breaks within an element
The break-inside property controls whether the browser should avoid splitting an element’s content across pages, columns, or regions. It can keep content such as a card together, but does not guarantee that the content remains unbroken.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
break-inside: auto | avoid | avoid-page | avoid-column | avoid-region;
page-break-inside: auto | avoid;break-inside controls fragmentation inside an element’s principal box, not text wrapping. Its initial value, auto, adds no constraints; the property is not inherited. Without a fragmentation context, it has no visible effect.
avoid discourages all break types, whereas avoid-page, avoid-column, and avoid-region target pages, columns, and regions respectively. avoid-region concerns flow through linked CSS Regions; a value appearing in the specification does not establish browser support.
Break avoidance is not an absolute prohibition: a forced break takes precedence, and insufficient space can require relaxing constraints. Apply the property to the container that should stay together, not to an ordinary inline element.
page-break-inside is a legacy compatibility alias: auto and avoid map to the same break-inside values. It does not expose the full set of its values. Prefer break-inside in new code; the example isolates column-break avoidance.
Examples
<!doctype html>
<meta charset="utf-8">
<title>break-inside</title>
<style>
.columns {
width: 320px;
height: 100px;
column-count: 2;
column-gap: 20px;
column-fill: auto;
font: 16px/20px monospace;
}
.lead { height: 60px; }
.card {
break-inside: avoid-column;
background: #def;
}
</style>
<div class="columns">
<div class="lead">A</div>
<div class="card"><div>B1</div><div>B2</div><div>B3</div></div>
</div>Result
Expected visual layout: A is in the first column. B1, B2, and B3 stay together at the top of the second column.
The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.