Layout & CSS More detail A2 · Formal specification Platform: Web

Containing Block

A containing block is the rectangle an element uses to work out its position and percentage size.

See how it works
You might call it positioning contextpercentage reference box

See how it works

Original worked exampleContaining Block

Another example

Place a sale badge 8px from its block start and 8px from its inline end. Setting `position: relative` on the card makes it the right containing block. A transformed carousel ancestor can no longer pull the badge to a far corner.

Main parts

  1. 01Establishing ancestor
  2. 02Reference rectangle
  3. 03Resolved inset or percentage

Use it when

Find the real containing block before fixing percentage sizes, absolute or sticky positions, or transformed parents.

Do not use it when

Do not assume it is always the nearest DOM parent or the viewport. Position and containment rules can change it.

Name used in code

positioning scheme + containing-block-establishing ancestor

Before you ship

Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience.

Request you can copy

Outcome: Use or define Containing Block to make the visual experience clear and easy to use. User context: Place a sale badge 8px from its block start and 8px from its inline end. Setting `position: relative` on the card makes it the right containing block. A transformed carousel ancestor can no longer pull the badge to a far corner. Design concept to apply: Containing Block. Why it fits: Find the real containing block before fixing percentage sizes, absolute or sticky positions, or transformed parents. Do not use it when: Do not assume it is always the nearest DOM parent or the viewport. Position and containment rules can change it. Design requirements: Set the content order, shared design values, and reusable components. Define how the layout changes by screen size and state. Keep useful design choices separate from decoration. Inclusion and resilience: Check contrast, zoom, languages, themes, and reduced motion when needed. Do not use color or effects as the only way to show meaning. Acceptance criteria: The design stays clear on phones and desktops, at zoom, in every theme, and in all supported languages. Interactive states stay clear and consistent. Evidence and limits (evidence boundary): A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support. Unknowns to confirm: Brand limits, amount of content, supported themes and languages, target devices, and design-system rules.

Check this request

Review the current use of Containing Block. Definition: A containing block is the rectangle an element uses to work out its position and percentage size. Release checks: Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.

A2
How official is this term?

Formal specification

A published, versioned formal specification defines this term for the listed technical scope.

A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support.

Scope
CSS containing blocks
Document status
draft
Checked on
2026-07-30

Evidence sources & scope

Authority source + Term reference · W3C CSS Working Group · draft CSS Positioned Layout Module Level 3 — Containing blocks of positioned boxes Containing blocks of positioned boxes Scope: CSS positioning; direct scope: Containing blocks of positioned boxes Role here: Direct term reference Source covers: canonical name, definition, semantics, implementation Authority source · W3C CSS Working Group · draft CSS Positioned Layout Module Level 3 Scope: CSS positioning Role here: Authority within stated scope Source covers: canonical name, definition, semantics, implementation Term reference W3C — CSS Positioned Layout Level 3: Containing Blocks Role here: Direct term reference

Copy it yourself

The browser could not copy this. Select the request below and copy it yourself.