Background Origin
Background-origin chooses the box used as the origin for positioning the background image. Content-box starts positioning inside the padding.
How it works
- A decorative effect should leave the content understandable when the effect is unavailable. Provide a readable background and normal document flow first.
- Inspect clipping, stacking, and contrast when adding layers; appearance changes do not always change the layout box.
A practical example
The HTML supplies the content; the CSS below styles it. Open both together in the playground, then change the lesson rules at the end of the stylesheet.
<article class="card"><span class="badge">This Saturday</span><h2>Neighbourhood repair club</h2><p>Bring a small project. Share a useful skill.</p><a href="#booking">View the workshop</a></article>
body { margin: 0; padding: 24px; font-family: system-ui, sans-serif; color: #25332d; background: #f4f7f2; }
.card { padding: 20px; background: white; border: 1px solid #d4dfd6; }
h2 { margin-top: 0; }
p { line-height: 1.6; }
a { color: #17634c; }
.badge { display: inline-block; margin-bottom: 12px; font-size: .8rem; }
.layout { display: grid; gap: 16px; }
.photo { width: 100%; height: 160px; background: linear-gradient(135deg, #e4af6b, #668cba); }
button, input, select { font: inherit; padding: 8px; }
label { display: block; margin-block: 12px 4px; }
/* This lesson */
.card { border: 12px dashed #a7bda9; padding: 30px; background-image: linear-gradient(#f7dba3, #c7e0ca); background-origin: content-box; background-repeat: no-repeat; }
Background-origin chooses the box used as the origin for positioning the background image. Content-box starts positioning inside the padding.