📄 tailwindcss/docs/grid-template-columns

File: grid-template-columns.md | Updated: 11/15/2025

Source: https://tailwindcss.com/docs/grid-template-columns

v4.1

⌘KCtrl KDocs Blog Showcase Sponsor Plus

  1. Flexbox & Grid
  2. grid-template-columns

Flexbox & Grid

grid-template-columns

Utilities for specifying the columns in a grid layout.

| Class | Styles | | --- | --- | | grid-cols-<number> | grid-template-columns: repeat(<number>, minmax(0, 1fr)); | | grid-cols-none | grid-template-columns: none; | | grid-cols-subgrid | grid-template-columns: subgrid; | | grid-cols-[<value>] | grid-template-columns: <value>; | | grid-cols-(<custom-property>) | grid-template-columns: var(<custom-property>); |

Examples


Specifying the grid columns

Use grid-cols-<number> utilities like grid-cols-2 and grid-cols-4 to create grids with n equally sized columns:

01

02

03

04

05

06

07

08

09

<div class="grid grid-cols-4 gap-4">  <div>01</div>  <!-- ... -->  <div>09</div></div>

Implementing a subgrid

Use the grid-cols-subgrid utility to adopt the column tracks defined by the item's parent:

01

02

03

04

05

06

<div class="grid grid-cols-4 gap-4">  <div>01</div>  <!-- ... -->  <div>05</div>  <div class="col-span-3 grid grid-cols-subgrid gap-4">    <div class="col-start-2">06</div>  </div></div>

Using a custom value

Use the grid-cols-[<value>] syntax to set the columns based on a completely custom value:

<div class="grid-cols-[200px_minmax(900px,_1fr)_100px] ...">  <!-- ... --></div>

For CSS variables, you can also use the grid-cols-(<custom-property>) syntax:

<div class="grid-cols-(--my-grid-cols) ...">  <!-- ... --></div>

This is just a shorthand for grid-cols-[var(<custom-property>)] that adds the var() function for you automatically.

Responsive design

Prefix a grid-template-columns utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:

<div class="grid grid-cols-1 md:grid-cols-6 ...">  <!-- ... --></div>

Learn more about using variants in the variants documentation .

On this page

Copyright © 2025 Tailwind Labs Inc.·Trademark Policy