CSS grid-template-columns Property

Description

The grid-template-columns CSS property is used in conjunction with CSS Grid Layout to define the columns within a grid container. It allows you to specify the size, width, and behavior of grid columns. You can set column sizes as fixed values (such as pixels or percentages), flexible fractions, or even use keywords like "auto" to let the grid automatically size the columns based on their content. This property helps create responsive and structured grid layouts, enabling precise control over the placement and sizing of grid items within the grid container's columns.

Initial value
none
Applies to
Grid containers
Inherited
No
Computed value
As specified
Animatable
Yes
JavaScript syntax
object.style.gridTemplateColumns

Interactive Demo

One
Two
Three
Four
Five

Syntax

grid-template-columns: none | <track-list> | <auto-track-list>
where 
<track-list> = [ <line-names>? [ <track-size> | <track-repeat> ] ]+ <line-names>?
<auto-track-list> = [ <line-names>? [ <fixed-size> | <fixed-repeat> ] ]* <line-names>? <auto-repeat>
[ <line-names>? [ <fixed-size> | <fixed-repeat> ] ]* <line-names>?
where 
<line-names> = '[' <custom-ident>* ']'
<track-size> = <track-breadth> | minmax( <inflexible-breadth> , <track-breadth> ) | fit-content( [ <length> | <percentage> ] )
<track-repeat> = repeat( [ <positive-integer> ] , [ <line-names>? <track-size> ]+ <line-names>? )
<fixed-size> = <fixed-breadth> | minmax( <fixed-breadth> , <track-breadth> ) | minmax( <inflexible-breadth> , <fixed-breadth> )
<fixed-repeat> = repeat( [ <positive-integer> ] , [ <line-names>? <fixed-size> ]+ <line-names>? )
<auto-repeat> = repeat( [ auto-fill | auto-fit ] , [ <line-names>? <fixed-size> ]+ <line-names>? )
where 
<track-breadth> = <length-percentage> | <flex> | min-content | max-content | auto
<inflexible-breadth> = <length> | <percentage> | min-content | max-content | auto
<fixed-breadth> = <length-percentage>
where 
<length-percentage> = <length> | <percentage>

Values

  • noneA keyword meaning that no explicit layout grid is created. Any columns will be generated implicitly, and their size will be determined using the grid-auto-columns property. This is the default value.
  • length / percentageSpecifies the size of the columns using a valid length value, or a percentage value. The value must be positive.
  • flexNon-negative value in "flexible" units of measure fr ( fractional unit ). Each column occupies a part of the remaining space in the container of the layout grid in proportion to the given coefficient. For example, when using the value 1fr 2fr , the columns will occupy ⅓ and ⅔ of the remaining space, respectively. The total size of such rows or columns is subtracted from the available space, which gives the remaining space, which is then divided between the rows and columns of flexible size in proportion to their coefficient. Values ​​between 0fr and 1fr have somewhat special behavior, when the sum of the coefficients is less than 1, they will occupy less than 100% of the remaining space. When the available space is infinite (the width or height of the layout grid container is undefined), the size of the flexible grid columns is determined by their contents while maintaining the appropriate proportions.
  • max-contentA keyword that sets the size of each column based on the largest item in the column.
  • min-contentA keyword that sets the size of each column based on the smallest item in the column.
  • minmax (min, max)Functional notation that defines a range of sizes greater than or equal to min and less than or equal to max . If max is less than min , then max is ignored, and the function is treated as min . The value in "flexible" units of measurement as the maximum value sets the coefficient of flexibility of the column, this is not acceptable for determining the minimum.
  • autoThe size of the columns is determined by the size of the container and the size of the contents of the elements in the column. As a maximum, it is identical to the value of max-content , but at least it represents the largest minimum size. Automatic column sizes can be stretched using align-content properties and justify-content.
  • fit-content (length | percentage)This is the formula min (max-content, max (auto, argument)) , which is calculated by analogy with auto (that is, minmax (auto, max-content) ), except that the size of the column is clamped by the argument value, if it is larger than the automatic minimum.
  • repeat ([positive-integer | auto-fill | auto-fit], track-list)Represents a repeated fragment of the track list, allowing a large number of columns that exhibit a recurring pattern to be written in a more compact form.

Example

<div class="grid-container">
<div>100px</div>
<div>auto</div>
<div>50px</div>
<div>auto</div>
<div>100px</div>
<div>auto</div>
<div>50px</div>
<div>auto</div>
</div>
<div class="grid-container2">
<div>1fr</div>
<div>1fr</div>
<div>2fr</div>
<div>1fr</div>
<div>1fr</div>
<div>2fr</div>
</div>
.grid-container,
.grid-container2 {
   display: grid;
   margin-top: 5px;
   padding: 10px; 
   background: rgb(0,150,208);
}
.grid-container > div,
.grid-container2 > div { 
   background: rgb(241,101,41); 
   border: 1px solid #000; 
   text-align: center; 
   padding: 20px 0; 
} 
.grid-container {
   grid-template-columns: 100px auto 50px auto;
}
.grid-container2 {
   grid-template-columns: 1fr 1fr 2fr;
}

Browser Support

The following table will show you the current browser support for the CSS grid-template-columns property.

Desktop
Edge Chrome Firefox Opera Safari
1657524410.1
Tablets / Mobile
Chrome Firefox Opera Safari Samsung Webview
57524310.3657

Last updated by CSSPortal on: 2nd January 2024