The column-width CSS property specifies the ideal column width in a multi-column layout. The container will have as many columns as can fit without any of them having a width less than the column-width value. If the width of the container is narrower than the specified value, the single column's width will be smaller than the declared column width.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
This property can help you create responsive designs that fit different screen sizes. Especially in the presence of the column-count property (which has precedence), you must specify all related length values to achieve an exact column width. In horizontal text these are width, column-width, column-gap, and column-rule-width.
Syntax
/* Keyword value */ column-width: auto; /* <length> values */ column-width: 60px; column-width: 15.5em; column-width: 3.3vw; /* Global values */ column-width: inherit; column-width: initial; column-width: unset;
The column-width property is specified as one of the values listed below.
Values
<length>- Indicates the optimal column width. The actual column width may differ from the specified value: it may be wider when necessary to fill available space, and narrower when the available space is too small. The value must be strictly positive or the declaration is invalid. Percentage values are also invalid.
auto- The width of the column is determined by other CSS properties, such as
column-count.
Formal syntax
<length> | auto
Example
HTML
<p class="content-box"> Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. </p>
CSS
.content-box {
column-width: 100px;
}
Result
Specifications
| Specification | Status | Comment |
|---|---|---|
| CSS Writing Modes Level 4 The definition of 'column-width' in that specification. |
Candidate Recommendation | Adds intrinsic sizes via the keywords min-content, max-content, fill-available, and fit-content. |
| CSS Multi-column Layout Module The definition of 'column-width' in that specification. |
Working Draft | Initial definition. |
| Initial value | auto |
|---|---|
| Applies to | Block containers except table wrapper boxes |
| Inherited | no |
| Media | visual |
| Computed value | the absolute length, zero or larger |
| Animation type | a length |
| Canonical order | per grammar |
Browser compatibility
| Desktop | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
| Basic support | Chrome
Full support
50
| Edge
Full support
12
| Firefox
Full support
50
| IE Full support 10 | Opera Full support 11.1 | Safari
Full support
3
| WebView Android Full support Yes | Chrome Android
Full support
50
| Edge Mobile
Full support
Yes
| Firefox Android
Full support
50
| Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android
Full support
5.0
|
| Intrinsic sizes | Chrome No support No | Edge ? | Firefox No support No | IE No support No | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android ? | Edge Mobile ? | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android ? |
On display: table-caption | Chrome Full support Yes | Edge Full support Yes | Firefox Full support 37 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support 50 | Edge Mobile Full support Yes | Firefox Android Full support 37 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support 5.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.
See Also
- Multiple-column Layout (Learn Layout)
- Basic Concepts of Multicol