Layout & CSS More detail A2 · Formal specification

Masonry Layout

A masonry layout packs items of different heights into columns. Items fill vertical gaps without sharing row lines.

See how it works
You might call it Pinterest gridwaterfall

See how it works

Original worked exampleMasonry Layout

Another example

An inspiration board fits tall and wide cards into balanced columns with little empty space.

Main parts

  1. 01Outer constraint
  2. 02Content and spacing model
  3. 03Computed size or reflow result

Use it when

Use it for browsing pictures when strict row-by-row comparison doesn't matter.

Do not use it when

Avoid it when source order, keyboard order, or the expected scan path gets confusing.

Name used in code

columns / masonry

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 Masonry Layout to make the visual experience clear and easy to use. User context: An inspiration board fits tall and wide cards into balanced columns with little empty space. Design concept to apply: Masonry Layout. Why it fits: Use it for browsing pictures when strict row-by-row comparison doesn't matter. Do not use it when: Avoid it when source order, keyboard order, or the expected scan path gets confusing. 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 Masonry Layout. Definition: A masonry layout packs items of different heights into columns. Items fill vertical gaps without sharing row lines. 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
Draft CSS masonry layout
Document status
draft
Checked on
2026-07-30

Evidence sources & scope

Authority source + Term reference · W3C CSS Working Group · draft CSS Grid Layout Module Level 3 — Grid lanes (masonry) layout model Grid lanes (masonry) layout model Scope: Experimental CSS masonry layout; direct scope: Grid lanes (masonry) layout model Role here: Direct term reference Source covers: canonical name, definition, semantics, implementation Authority source · W3C CSS Working Group · draft CSS Grid Layout Module Level 3 Scope: Experimental CSS masonry layout Role here: Authority within stated scope Source covers: canonical name, definition, semantics, implementation

Copy it yourself

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