- CSS Grid Layout Module
- Browser Support
- Grid Elements
- Example
- Display Property
- Example
- Example
- Grid Columns
- Grid Rows
- Grid Gaps
- Example
- Example
- Example
- Example
- Grid Lines
- Example
- Example
- All CSS Grid Properties
- CSS grid layout
- Basic example
- HTML
- CSS
- Reference
- Properties
- Functions
- Data types
- Guides
- Specifications
- See also
- Found a content problem with this page?
- MDN
- Support
- Our communities
- Developers
CSS Grid Layout Module
The CSS Grid Layout Module offers a grid-based layout system, with rows and columns, making it easier to design web pages without having to use floats and positioning.
Browser Support
The grid properties are supported in all modern browsers.
Grid Elements
A grid layout consists of a parent element, with one or more child elements.
Example
Display Property
An HTML element becomes a grid container when its display property is set to grid or inline-grid .
Example
Example
All direct children of the grid container automatically become grid items.
Grid Columns
The vertical lines of grid items are called columns.
Grid Rows
The horizontal lines of grid items are called rows.
Grid Gaps
The spaces between each column/row are called gaps.
You can adjust the gap size by using one of the following properties:
Example
The column-gap property sets the gap between the columns:
Example
The row-gap property sets the gap between the rows:
Example
The gap property is a shorthand property for the row-gap and the column-gap properties:
Example
The gap property can also be used to set both the row gap and the column gap in one value:
Grid Lines
The lines between columns are called column lines.
The lines between rows are called row lines.
Refer to line numbers when placing a grid item in a grid container:
Example
Place a grid item at column line 1, and let it end on column line 3:
Example
Place a grid item at row line 1, and let it end on row line 3:
All CSS Grid Properties
Property | Description |
---|---|
column-gap | Specifies the gap between the columns |
gap | A shorthand property for the row-gap and the column-gap properties |
grid | A shorthand property for the grid-template-rows, grid-template-columns, grid-template-areas, grid-auto-rows, grid-auto-columns, and the grid-auto-flow properties |
grid-area | Either specifies a name for the grid item, or this property is a shorthand property for the grid-row-start, grid-column-start, grid-row-end, and grid-column-end properties |
grid-auto-columns | Specifies a default column size |
grid-auto-flow | Specifies how auto-placed items are inserted in the grid |
grid-auto-rows | Specifies a default row size |
grid-column | A shorthand property for the grid-column-start and the grid-column-end properties |
grid-column-end | Specifies where to end the grid item |
grid-column-gap | Specifies the size of the gap between columns |
grid-column-start | Specifies where to start the grid item |
grid-gap | A shorthand property for the grid-row-gap and grid-column-gap properties |
grid-row | A shorthand property for the grid-row-start and the grid-row-end properties |
grid-row-end | Specifies where to end the grid item |
grid-row-gap | Specifies the size of the gap between rows |
grid-row-start | Specifies where to start the grid item |
grid-template | A shorthand property for the grid-template-rows, grid-template-columns and grid-areas properties |
grid-template-areas | Specifies how to display columns and rows, using named grid items |
grid-template-columns | Specifies the size of the columns, and how many columns in a grid layout |
grid-template-rows | Specifies the size of the rows in a grid layout |
row-gap | Specifies the gap between the grid rows |
CSS grid layout
The CSS grid layout module excels at dividing a page into major regions or defining the relationship in terms of size, position, and layer, between parts of a control built from HTML primitives.
Like tables, grid layout enables an author to align elements into columns and rows. However, many more layouts are either possible or easier with CSS grid than they were with tables. For example, a grid container’s child elements could position themselves so they actually overlap and layer, similar to CSS positioned elements.
Basic example
The example below shows a three-column track grid with new rows created at a minimum of 100 pixels and a maximum of auto. Items have been placed onto the grid using line-based placement.
* box-sizing: border-box; > .wrapper max-width: 940px; margin: 0 auto; > .wrapper > div border: 2px solid rgb(233 171 88); border-radius: 5px; background-color: rgba(233 171 88 / 0.5); padding: 1em; color: #d9480f; >
HTML
div class="wrapper"> div class="one">Onediv> div class="two">Twodiv> div class="three">Threediv> div class="four">Fourdiv> div class="five">Fivediv> div class="six">Sixdiv> div>
CSS
.wrapper display: grid; grid-template-columns: repeat(3, 1fr); gap: 10px; grid-auto-rows: minmax(100px, auto); > .one grid-column: 1 / 3; grid-row: 1; > .two grid-column: 2 / 4; grid-row: 1 / 3; > .three grid-column: 1; grid-row: 2 / 5; > .four grid-column: 3; grid-row: 3; > .five grid-column: 2; grid-row: 4; > .six grid-column: 3; grid-row: 4; >
Reference
Properties
- display
- grid-template-columns
- grid-template-rows
- grid-template-areas
- grid-template
- grid-auto-columns
- grid-auto-rows
- grid-auto-flow
- grid
- grid-row-start
- grid-column-start
- grid-row-end
- grid-column-end
- grid-row
- grid-column
- grid-area
- row-gap
- column-gap
- gap
- masonry-auto-flow Experimental
- align-tracks Experimental
- justify-tracks Experimental
Functions
Data types
Guides
- Basic concepts of grid layout
- Relationship of grid layout with other layout methods
- Grid template areas
- Grid layout using line-based placement
- Grid layout using named grid lines
- Auto-placement in grid layout
- Box alignment in grid layout
- Grids, logical values, and writing modes
- Grid layout and accessibility
- Realizing common layouts using grids
- Subgrid
- Masonry layout Experimental
Specifications
See also
- Glossary terms:
- Grid
- Grid lines
- Grid tracks
- Grid cell
- Grid area
- Gutters
- Grid axis
- Grid row
- Grid column
Found a content problem with this page?
This page was last modified on Jun 15, 2023 by MDN contributors.
Your blueprint for a better internet.
MDN
Support
Our communities
Developers
Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998– 2023 by individual mozilla.org contributors. Content available under a Creative Commons license.