gap

Utilities for controlling gutters between grid and flexbox items.

Quick reference

Class	Styles
gap-<number>	gap: calc(var(--spacing) * <value>);
gap-(<custom-property>)	gap: var(<custom-property>);
gap-[<value>]	gap: <value>;
gap-x-<number>	column-gap: calc(var(--spacing) * <value>);
gap-x-(<custom-property>)	column-gap: var(<custom-property>);
gap-x-[<value>]	column-gap: <value>;
gap-y-<number>	row-gap: calc(var(--spacing) * <value>);
gap-y-(<custom-property>)	row-gap: var(<custom-property>);
gap-y-[<value>]	row-gap: <value>;

Examples

Basic example

Use gap-<number> utilities like gap-2 and gap-4 to change the gap between both rows and columns in grid and flexbox layouts:

<!-- [!code classes:gap-4] -->
<div class="grid grid-cols-2 gap-4">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
</div>

Changing row and column gaps independently

Use gap-x-<number> or gap-y-<number> utilities like gap-x-8 and gap-y-4 to change the gap between columns and rows independently:

<!-- [!code classes:gap-x-8,gap-y-4] -->
<div class="grid grid-cols-3 gap-x-8 gap-y-4">
  <div>01</div>
  <div>02</div>
  <div>03</div>
  <div>04</div>
  <div>05</div>
  <div>06</div>
</div>

Using a custom value

Use the gap-[<value>] syntax to set the gap based on a completely custom value:

<div class="grid gap-[10vw] ...">
  <!-- ... -->
</div>

For CSS variables, you can also use the gap-(<custom-property>) syntax:

<div class="grid gap-(--my-gap) ...">
  <!-- ... -->
</div>

This is just a shorthand for gap-[var(<custom-property>)] that adds the var() function for you automatically.

Responsive design

Prefix a gap utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:

<div class="grid gap-4 md:gap-6 ...">
  <!-- ... -->
</div>