Utilities for controlling gutters between grid and flexbox items.
<div class="grid gap-4 grid-cols-2">
<div>1</div>
<div>2</div>
<div>3</div>
<div>4</div>
</div>
Use gap-x-{size}
and gap-y-{size}
to change the gap between rows and columns independently.
<div class="grid gap-x-8 gap-y-4 grid-cols-3">
<div>1</div>
<div>2</div>
<div>3</div>
<div>4</div>
<div>5</div>
<div>6</div>
</div>
To control the gap at a specific breakpoint, add a {screen}:
prefix to any existing gap utility. For example, use md:gap-6
to apply the gap-6
utility at only medium screen sizes and above.
<div class="grid gap-4 md:gap-6 ...">
<!-- ... -->
</div>
For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.
By default, Tailwind’s gap scale matches your configured spacing scale.
You can customize the global spacing scale in the theme.spacing
or theme.extend.spacing
sections of your tailwind.config.js
file:
// tailwind.config.js
module.exports = {
theme: {
extend: {
spacing: {
+ '72': '18rem',
+ '84': '21rem',
+ '96': '24rem',
}
}
}
}
To customize the gap scale separately, use the gap
section of your Tailwind theme config.
// tailwind.config.js
module.exports = {
theme: {
extend: {
gap: {
+ '11': '2.75rem',
+ '13': '3.25rem',
}
}
}
}
Learn more about customizing the default theme in the theme customization documentation.
By default, only responsive variants are generated for gap utilities.
You can control which variants are generated for the gap utilities by modifying the gap
property in the variants
section of your tailwind.config.js
file.
For example, this config will also generate hover and focus variants:
// tailwind.config.js
module.exports = {
variants: {
extend: {
// ...
+ gap: ['hover', 'focus'],
}
}
}
If you don't plan to use the gap utilities in your project, you can disable them entirely by setting the gap
property to false
in the corePlugins
section of your config file:
// tailwind.config.js
module.exports = {
corePlugins: {
// ...
+ gap: false,
}
}