diff --git a/docs/content/utilities/flexbox.md b/docs/content/utilities/flexbox.md
index 3b6558a1..78641c78 100644
--- a/docs/content/utilities/flexbox.md
+++ b/docs/content/utilities/flexbox.md
@@ -487,44 +487,74 @@ When the main axis wraps, this creates multiple main axis lines and adds extra s
Use this class to specify the ability of a flex item to alter its dimensions to fill available space.
```css
-.flex-auto { flex: 1 1 auto; }
-.flex-grow-0 { flex-grow: 0; }
-.flex-shrink-0 { flex-shrink: 0; }
+.flex-1 { flex: 1; }
+.flex-auto { flex: auto; }
+.flex-grow-0 { flex-grow: 0; }
+.flex-shrink-0 { flex-shrink: 0; }
```
| Class | Description |
| --- | --- |
-| `.flex-auto` | Sets default values for `flex-grow` (1), `flex-shrink` (1) and `flex-basis` (auto) |
-| `.flex-grow-0` | Prevents growing of a flex item |
-| `.flex-shrink-0` | Prevents shrinking of a flex item |
+| `.flex-1` | Fills available space |
+| `.flex-auto` | Fills available space and auto-sizes based on the content |
+| `.flex-grow-0` | Prevents growing of a flex item |
+| `.flex-shrink-0` | Prevents shrinking of a flex item |
-#### flex-auto
+#### flex-1
+
+Adding `.flex-1` makes the item grow in size to take up all the space that is available.
```html live
-
.flex-auto
-
.flex-auto
-
.flex-auto
+
flex item
+
.flex-1
+
flex item
+
+```
+
+Adding `.flex-1` to all flex items results in each item having the same size.
+
+```html live
+
+
.flex-1
+
.flex-1
+
.flex-1
+
+```
+
+#### flex-auto
+
+Using `.flex-auto` fills the available space but also takes the size of the content into account. Type in the editor below to see the effect.
+
+```html live
+
+
.flex-1
+
.flex-auto with a bit more text
+
.flex-1
```
#### flex-grow-0
+Add `.flex-grow-0` to prevent an item from growing. This can be useful when used as a responsive variant. For example to stop growing when the viewport gets wider.
+
```html live
-
.flex-auto
-
.flex-auto .flex-grow-0
-
.flex-auto
+
flex item
+
.flex-auto .flex-md-grow-0
+
flex item
```
#### flex-shrink-0
+Add `.flex-shrink-0` to prevent an item from shrinking. Note that for example text will not wrap and the flex items start to overflow if there is not enough space.
+
```html live
-
-
.flex-auto
-
.flex-auto .flex-shrink-0
-
.flex-auto
+
+
flex item
+
.flex-shrink-0
+
flex item
```
@@ -663,7 +693,6 @@ All flexbox utilities can be adjusted per [breakpoint](/css/objects/grid#breakpo
- `d-[breakpoint]-[property]` for `display`
- `flex-[breakpoint]-[property]-[behavior]` for various flex properties
-- `flex-[breakpoint]-item-equal` for equal width and equal height flex items
Each responsive style is applied to the specified breakpoint and up.
@@ -682,8 +711,6 @@ Each responsive style is applied to the specified breakpoint and up.
.flex-lg-nowrap {}
.flex-lg-self-start {}
-
-.flex-md-item-equal {}
```
#### Example usage
@@ -698,16 +725,6 @@ Mixing flex properties:
```
-Using the equal width, equal height utilities:
-
-```html live
-
-
Stuff and things
-
More stuff
on multiple lines
-
Hi mom
-
-```
-
## Example components
The flex utilities can be used to create a number of components. Here are some examples.
diff --git a/src/utilities/flexbox.scss b/src/utilities/flexbox.scss
index 7f93c3ad..a0cd73a5 100644
--- a/src/utilities/flexbox.scss
+++ b/src/utilities/flexbox.scss
@@ -32,8 +32,9 @@
.flex#{$variant}-content-stretch { align-content: stretch !important; }
// Item
- .flex#{$variant}-auto { flex: 1 1 auto !important; }
- .flex#{$variant}-grow-0 { flex-grow: 0 !important; }
+ .flex#{$variant}-1 { flex: 1 !important; }
+ .flex#{$variant}-auto { flex: auto !important; }
+ .flex#{$variant}-grow-0 { flex-grow: 0 !important; }
.flex#{$variant}-shrink-0 { flex-shrink: 0 !important; }
.flex#{$variant}-self-auto { align-self: auto !important; }
@@ -43,12 +44,6 @@
.flex#{$variant}-self-baseline { align-self: baseline !important; }
.flex#{$variant}-self-stretch { align-self: stretch !important; }
- // Shorthand for equal width and height cols
- .flex#{$variant}-item-equal {
- flex-grow: 1;
- flex-basis: 0;
- }
-
.flex#{$variant}-order-1 { order: 1 !important; }
.flex#{$variant}-order-2 { order: 2 !important; }
.flex#{$variant}-order-none { order: inherit !important; }