Gap

Source: https://getbootstrap.com/docs/6.0/utilities/gap

Use gap utilities to control the space between elements in flexbox or grid layouts. Includes support for individual row and column gaps.

Overview

Use gap utilities to control the space between children in flexbox and grid layouts. Gap utilities are built from a default Sass map ranging from 0 to 3rem (.gap-0 through .gap-12). Use utilities like .gap-3 and .gap-5 to control the gap between all children:

<Example class="d-flex align-items-center justify-content-center gap-4 text-center" showMarkup={false} code={&lt;div class="d-flex gap-3 p-3 bd-pattern-diagonal rounded-3"> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 1&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 2&lt;/div> &lt;/div> &lt;div class="d-flex gap-5 p-3 bd-pattern-diagonal rounded-3"> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 1&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 2&lt;/div> &lt;/div>} />

<div class="d-flex gap-3">...</div>
<div class="d-flex gap-5">...</div>

Support note: Gap utilities work with CSS Grid and Flexbox layouts. They are a modern alternative to margin utilities for spacing children within a container.

Notation

<SpacingNotation noun="gap" format="{property}-{size}" properties={[ { class: 'gap', property: 'gap' }, { class: 'row-gap', property: 'row-gap' }, { class: 'column-gap', property: 'column-gap' } ]} />

Examples

Flexbox gap

Use gap utilities to control the space between children in a flexbox container:

<Example showMarkup={false} class="d-flex align-items-center justify-content-center text-center" code={&lt;div class="d-flex gap-4 bd-pattern-diagonal rounded-3"> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 1&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 2&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 3&lt;/div> &lt;/div>} />

<div class="d-flex gap-4">
  <div>Item 1</div>
  <div>Item 2</div>
  <div>Item 3</div>
</div>

Grid gap

Gap utilities also work with CSS Grid layouts:

<Example showMarkup={false} class="d-flex align-items-center justify-content-center text-center" code={&lt;div class="d-grid gap-3 bd-pattern-diagonal rounded-3" style="grid-template-columns: 1fr 1fr;"> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 1&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 2&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 3&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 4&lt;/div> &lt;/div>} />

<div class="d-grid gap-3" style="grid-template-columns: 1fr 1fr;">
  <div>Item 1</div>
  <div>Item 2</div>
  <div>Item 3</div>
  <div>Item 4</div>
</div>

Row and column gaps

Use row-gap and column-gap utilities to control the space between rows and columns independently:

<Example showMarkup={false} class="d-flex align-items-center justify-content-center text-center" code={&lt;div class="d-grid row-gap-4 column-gap-2 bd-pattern-diagonal rounded-3" style="grid-template-columns: 1fr 1fr 1fr;"> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 1&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 2&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 3&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 4&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 5&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 6&lt;/div> &lt;/div>} />

<div class="d-grid row-gap-4 column-gap-2" style="grid-template-columns: 1fr 1fr 1fr;">
  <div>Item 1</div>
  <div>Item 2</div>
  <div>Item 3</div>
  <div>Item 4</div>
  <div>Item 5</div>
  <div>Item 6</div>
</div>

Flexbox with wrapping

You can also use row-gap and column-gap utilities with flexbox layouts that wrap:

<Example showMarkup={false} class="d-flex align-items-center justify-content-center text-center" code={&lt;div class="d-flex flex-wrap row-gap-3 column-gap-2 p-3 bd-pattern-diagonal rounded-3"> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 1&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 2&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 3&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 4&lt;/div> &lt;div class="p-3 bg-subtle-accent fg-accent rounded-3">Item 5&lt;/div> &lt;/div>} />

<div class="d-flex flex-wrap row-gap-3 column-gap-2">
  <div>Item 1</div>
  <div>Item 2</div>
  <div>Item 3</div>
  <div>Item 4</div>
  <div>Item 5</div>
</div>

Responsive

All gap utilities are responsive and include all breakpoints.

CSS

Sass utilities API

Gap utilities are declared in our utilities API in scss/_utilities.scss. Learn how to use the utilities API.