The <a href="/en-US/docs/Web/CSS">CSS</a> <strong><code>align-items</code></strong> property sets the <a href="/en-US/docs/Web/CSS/align-self"><code>align-self</code></a> value on all direct children as a group. In Flexbox, it controls the alignment of items on the <a href="/en-US/docs/Glossary/CrossAxis">Cross Axis</a>. In Grid Layout, it controls the alignment of items on the Block Axis within their <a href="/en-US/docs/Glossary/GridAreas">grid area</a>.

<pre class="brush: css notranslate"><code><span class="token comment">/ Basic keywords /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> normal<span class="token punctuation">;</span> <span class="token property">align-items</span><span class="token punctuation">:</span> stretch<span class="token punctuation">;</span> <span class="token comment">/ Positional alignment /</span> <span class="token comment">/ align-items does not take left and right values /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> center<span class="token punctuation">;</span> <span class="token comment">/ Pack items around the center /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> start<span class="token punctuation">;</span> <span class="token comment">/ Pack items from the start /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> end<span class="token punctuation">;</span> <span class="token comment">/ Pack items from the end /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> flex-start<span class="token punctuation">;</span> <span class="token comment">/ Pack flex items from the start /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> flex-end<span class="token punctuation">;</span> <span class="token comment">/ Pack flex items from the end /</span> <span class="token comment">/ Baseline alignment /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> baseline<span class="token punctuation">;</span> <span class="token property">align-items</span><span class="token punctuation">:</span> first baseline<span class="token punctuation">;</span> <span class="token property">align-items</span><span class="token punctuation">:</span> last baseline<span class="token punctuation">;</span> <span class="token comment">/ Overflow alignment (for positional alignment only) /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> safe center<span class="token punctuation">;</span> <span class="token property">align-items</span><span class="token punctuation">:</span> unsafe center<span class="token punctuation">;</span> <span class="token comment">/ Global values /</span> <span class="token property">align-items</span><span class="token punctuation">:</span> inherit<span class="token punctuation">;</span> <span class="token property">align-items</span><span class="token punctuation">:</span> initial<span class="token punctuation">;</span> <span class="token property">align-items</span><span class="token punctuation">:</span> revert<span class="token punctuation">;</span> <span class="token property">align-items</span><span class="token punctuation">:</span> unset<span class="token punctuation">;</span> </code></pre>

align-items

The CSS align-items property sets the align-self value on all direct children as a group. In Flexbox, it controls the alignment of items on the Cross Axis. In Grid Layout, it controls the alignment of items on the Block Axis within their grid area.

The interactive example below demonstrates some of the values for align-items using grid layout.

Syntax

/* Basic keywords */ align-items: normal; align-items: stretch;  /* Positional alignment */ /* align-items does not take left and right values */ align-items: center; /* Pack items around the center */ align-items: start; /* Pack items from the start */ align-items: end; /* Pack items from the end */ align-items: flex-start; /* Pack flex items from the start */ align-items: flex-end; /* Pack flex items from the end */  /* Baseline alignment */ align-items: baseline; align-items: first baseline; align-items: last baseline; /* Overflow alignment (for positional alignment only) */ align-items: safe center; align-items: unsafe center;  /* Global values */ align-items: inherit; align-items: initial; align-items: revert; align-items: unset; 

Values

normal

The effect of this keyword is dependent of the layout mode we are in:

In absolutely-positioned layouts, the keyword behaves like start on replaced absolutely-positioned boxes, and as stretch on all other absolutely-positioned boxes. In static position of absolutely-positioned layouts, the keyword behaves as stretch. For flex items, the keyword behaves as stretch. For grid items, this keyword leads to a behavior similar to the one of stretch, except for boxes with an aspect ratio or an intrinsic sizes where it behaves like start. The property doesn't apply to block-level boxes, and to table cells. flex-start

The cross-start margin edges of the flex items are flushed with the cross-start edge of the line.

flex-end

The cross-end margin edges of the flex items are flushed with the cross-end edge of the line.

center

The flex items' margin boxes are centered within the line on the cross-axis. If the cross-size of an item is larger than the flex container, it will overflow equally in both directions.

start

The items are packed flush to each other toward the start edge of the alignment container in the appropriate axis.

end

The items are packed flush to each other toward the end edge of the alignment container in the appropriate axis.

self-start

The items are packed flush to the edge of the alignment container of the start side of the item, in the appropriate axis.

self-end

The items are packed flush to the edge of the alignment container of the end side of the item, in the appropriate axis.

baseline, first baseline, last baseline

All flex items are aligned such that their flex container baselines align. The item with the largest distance between its cross-start margin edge and its baseline is flushed with the cross-start edge of the line.

stretch

Flex items are stretched such that the cross-size of the item's margin box is the same as the line while respecting width and height constraints.

safe

Used alongside an alignment keyword. If the chosen keyword means that the item overflows the alignment container causing data loss, the item is instead aligned as if the alignment mode were start.

unsafe

Used alongside an alignment keyword. Regardless of the relative sizes of the item and alignment container and whether overflow which causes data loss might happen, the given alignment value is honored.

Formal definition

Initial value	normal
Applies to	all elements
Inherited	no
Computed value	as specified
Animation type	discrete

Formal syntax

normal | stretch | <baseline-position> | [ <overflow-position>? <self-position> ]
where <baseline-position> = [ first | last ]? baseline<overflow-position> = unsafe | safe<self-position> = center | start | end | self-start | self-end | flex-start | flex-end

Examples

CSS

#container {   height:200px;   width: 240px;   align-items: center; /* Can be changed in the live sample */   background-color: #8c8c8c; }  .flex {   display: flex;   flex-wrap: wrap; }  .grid {   display: grid;   grid-template-columns: repeat(auto-fill, 50px); }  div > div {   box-sizing: border-box;   border: 2px solid #8c8c8c;   width: 50px;   display: flex;   align-items: center;   justify-content: center; }  #item1 {   background-color: #8cffa0;   min-height: 30px; }  #item2 {   background-color: #a0c8ff;   min-height: 50px; }  #item3 {   background-color: #ffa08c;   min-height: 40px; }  #item4 {   background-color: #ffff8c;   min-height: 60px; }  #item5 {   background-color: #ff8cff;   min-height: 70px; }  #item6 {   background-color: #8cffff;   min-height: 50px;   font-size: 30px; }  select {   font-size: 16px; }  .row {   margin-top: 10px; } 

HTML

<div id="container" class="flex">   <div id="item1">1</div>   <div id="item2">2</div>   <div id="item3">3</div>   <div id="item4">4</div>   <div id="item5">5</div>   <div id="item6">6</div> </div>  <div class="row">   <label for="display">display: </label>   <select id="display">     <option value="flex">flex</option>     <option value="grid">grid</option>   </select> </div>  <div class="row">   <label for="values">align-items: </label>   <select id="values">     <option value="normal">normal</option>     <option value="flex-start">flex-start</option>     <option value="flex-end">flex-end</option>     <option value="center" selected>center</option>     <option value="baseline">baseline</option>     <option value="stretch">stretch</option>      <option value="start">start</option>     <option value="end">end</option>     <option value="self-start">self-start</option>     <option value="self-end">self-end</option>     <option value="left">left</option>     <option value="right">right</option>      <option value="first baseline">first baseline</option>     <option value="last baseline">last baseline</option>      <option value="safe center">safe center</option>     <option value="unsafe center">unsafe center</option>     <option value="safe right">safe right</option>     <option value="unsafe right">unsafe right</option>     <option value="safe end">safe end</option>     <option value="unsafe end">unsafe end</option>     <option value="safe self-end">safe self-end</option>     <option value="unsafe self-end">unsafe self-end</option>     <option value="safe flex-end">safe flex-end</option>     <option value="unsafe flex-end">unsafe flex-end</option>   </select> </div> 

var values = document.getElementById('values'); var display = document.getElementById('display'); var container = document.getElementById('container');  values.addEventListener('change', function (evt) {   container.style.alignItems = evt.target.value; });  display.addEventListener('change', function (evt) {   container.className = evt.target.value; }); 

Result

Specifications

Specification
CSS Box Alignment Module Level 3 # align-items-property
CSS Flexible Box Layout Module Level 1 # align-items-property

See also

CSS Flexbox Guide: Basic Concepts of Flexbox CSS Flexbox Guide: Aligning items in a flex container CSS Grid Guide: Box alignment in CSS Grid layouts CSS Box Alignment The align-self property

Last modified: Sep 15, 2021, by MDN contributors

Select your preferred language English (US)DeutschEspañolFrançais日本語Português (do Brasil)Русский中文 (简体) Change language