`place-items` CSS property
The place-items CSS shorthand property aligns items along both block and inline directions at the same time.
The place-items CSS shorthand property aligns items along both block and inline directions at the same time.
CSS Demo: place-items
```css interactive-example-choice place-items: center stretch;
```css interactive-example-choice
place-items: center start;
```css interactive-example-choice place-items: start end;
```css interactive-example-choice
place-items: end center;
```html interactive-example
```css interactive-example
#example-element {
border: 1px solid #c5c5c5;
display: grid;
grid-template-columns: 1fr 1fr;
grid-auto-rows: 80px;
grid-gap: 10px;
width: 220px;
}
#example-element > div {
background-color: rgb(0 0 255 / 0.2);
border: 3px solid blue;
}
Constituent properties
This property is a shorthand for the following CSS properties:
- align-items
- justify-items
Syntax
/* Positional alignment */
place-items: center;
place-items: normal start;
place-items: center normal;
place-items: start legacy;
place-items: end normal;
place-items: self-start legacy;
place-items: self-end normal;
place-items: flex-start legacy;
place-items: flex-end normal;
place-items: anchor-center;
/* Baseline alignment */
place-items: baseline normal;
place-items: first baseline legacy;
place-items: last baseline normal;
place-items: stretch legacy;
/* Global values */
place-items: inherit;
place-items: initial;
place-items: revert;
place-items: revert-layer;
place-items: unset;
Values
This property is specified as one or two space-separated values of the following types, in the order listed:
- align-items
- : Specifies the alignment in the block direction.
- justify-items
- : Specifies the alignment in the inline direction. If omitted, the
align-itemsvalue is used.
Description
The place-items shorthand property sets align-items and justify-items in a single declaration, aligning items along both the block and inline directions.
If only one value is provided, the value is used to set alignment in both block and inline directions. If two values are provided, the first value is the align-items value, setting the alignment in the block direction, and the second value is the justify-items value, setting alignment in the inline direction.
Formal definition
Formal syntax
Examples
Placing items in a flex container
In flexbox justify-self or justify-items do not apply, as on the main axis items are treated as a group. Therefore, the second value will be ignored.
```css hidden 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; font-size: 2em; }
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; }
select { font-size: 16px; }
.row { margin-top: 10px; }
```html hidden
<div id="container">
<div id="item1">1</div>
<div id="item2">2</div>
<div id="item3">3</div>
</div>
<div class="row">
<label for="values">place-items: </label>
<select id="values">
<option value="stretch">stretch</option>
<option value="start">start</option>
<option value="center">center</option>
<option value="end">end</option>
<option value="left">left</option>
<option value="right">right</option>
<option value="auto center">auto center</option>
<option value="normal start">normal start</option>
<option value="center normal">center normal</option>
<option value="start auto">start auto</option>
<option value="end normal">end normal</option>
<option value="self-start auto">self-start auto</option>
<option value="self-end normal">self-end normal</option>
<option value="flex-start auto">flex-start auto</option>
<option value="flex-end normal">flex-end normal</option>
<option value="left auto">left auto</option>
<option value="right normal">right normal</option>
<option value="baseline normal">baseline normal</option>
<option value="first baseline auto">first baseline auto</option>
<option value="last baseline normal">last baseline normal</option>
<option value="stretch auto">stretch auto</option>
</select>
</div>
```js hidden const values = document.getElementById("values"); const container = document.getElementById("container");
values.addEventListener("change", (evt) => { container.style.placeItems = evt.target.value; });
#### CSS
```css
#container {
height: 200px;
width: 240px;
place-items: stretch; /* You can change this value by selecting another option in the list */
background-color: #8c8c8c;
display: flex;
}
Result
260
Placing items in a grid container
The following grid container has items which are smaller than the grid areas they are placed in, therefore place-items will move them in the block and inline dimensions.
```css hidden div > div { box-sizing: border-box; border: 2px solid #8c8c8c; }
item1 {
background-color: #8cffa0; min-height: 30px; font-size: 2em; }
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; }
select { font-size: 16px; }
.row { margin-top: 10px; }
```html hidden
<div id="grid-container">
<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>
<div class="row">
<label for="grid-values">place-items: </label>
<select id="grid-values">
<option value="stretch">stretch</option>
<option value="start">start</option>
<option value="center">center</option>
<option value="end">end</option>
<option value="left">left</option>
<option value="right">right</option>
<option value="auto center">auto center</option>
<option value="normal start">normal start</option>
<option value="center normal">center normal</option>
<option value="start auto">start auto</option>
<option value="end normal">end normal</option>
<option value="self-start auto">self-start auto</option>
<option value="self-end normal">self-end normal</option>
<option value="flex-start auto">flex-start auto</option>
<option value="flex-end normal">flex-end normal</option>
<option value="left auto">left auto</option>
<option value="right normal">right normal</option>
<option value="baseline normal">baseline normal</option>
<option value="first baseline auto">first baseline auto</option>
<option value="last baseline normal">last baseline normal</option>
<option value="stretch auto">stretch auto</option>
</select>
</div>
```js hidden const values = document.getElementById("grid-values"); const container = document.getElementById("grid-container");
values.addEventListener("change", (evt) => { container.style.placeItems = evt.target.value; });
#### CSS
```css
#grid-container {
height: 200px;
width: 240px;
place-items: stretch; /* You can change this value by selecting another option in the list */
background-color: #8c8c8c;
display: grid;
grid-template-columns: repeat(3, 1fr);
}
#grid-container > div {
width: 50px;
}
Result
260
Specifications
Browser compatibility
See also
- align-items
- align-self
- justify-items
- justify-self
- Basic concepts of flexbox
- Aligning items in a flex container
- Box alignment in grid layout
- CSS box alignment module