Quick reference

Class
Properties
divide-x-0 > * + *border-right-width: 0px; border-left-width: 0px;
divide-x-2 > * + *border-right-width: 2px; border-left-width: 0px;
divide-x-4 > * + *border-right-width: 4px; border-left-width: 0px;
divide-x-8 > * + *border-right-width: 8px; border-left-width: 0px;
divide-x > * + *border-right-width: 1px; border-left-width: 0px;
divide-y-0 > * + *border-top-width: 0px; border-bottom-width: 0px;
divide-y-2 > * + *border-top-width: 0px; border-bottom-width: 2px;
divide-y-4 > * + *border-top-width: 0px; border-bottom-width: 4px;
divide-y-8 > * + *border-top-width: 0px; border-bottom-width: 8px;
divide-y > * + *border-top-width: 0px; border-bottom-width: 1px;
divide-y-reverse > * + *--tw-divide-y-reverse: 1;
divide-x-reverse > * + *--tw-divide-x-reverse: 1;

Basic usage

Add borders between horizontal children

Add borders between horizontal elements using the divide-x-{width} utilities.

01
02
03
<div class="grid grid-cols-3 divide-x">
  <div>01</div>
  <div>02</div>
  <div>03</div>
</div>

Add borders between stacked children

Add borders between stacked elements using the divide-y-{width} utilities.

01
02
03
<div class="grid grid-cols-1 divide-y">
  <div>01</div>
  <div>02</div>
  <div>03</div>
</div>

Reversing children order

If your elements are in reverse order (using say flex-row-reverse or flex-col-reverse), use the divide-x-reverse or divide-y-reverse utilities to ensure the border is added to the correct side of each element.

01
02
03
<div class="flex flex-col-reverse divide-y divide-y-reverse">
  <div>01</div>
  <div>02</div>
  <div>03</div>
</div>

Applying conditionally

Hover, focus, and other states

Tailwind lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:divide-y-8 to only apply the divide-y-8 utility on hover.

<div class="divide-y divide-gray-400 hover:divide-y-8">
  <!-- ... -->
</div>

For a complete list of all available state modifiers, check out the Hover, Focus, & Other States documentation.

Breakpoints and media queries

You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. For example, use md:divide-y-8 to apply the divide-y-8 utility at only medium screen sizes and above.

<div class="divide-y divide-gray-400 md:divide-y-8">
  <!-- ... -->
</div>

To learn more, check out the documentation on Responsive Design, Dark Mode and other media query modifiers.


Using custom values

Customizing your theme

The divide width scale inherits its values from the borderWidth scale by default, so if you’d like to customize your values for both border width and divide width together, use the theme.borderWidth section of your tailwind.config.js file.

tailwind.config.js
module.exports = {
  theme: {
    borderWidth: {
      DEFAULT: '1px',
      '0': '0',
      '2': '2px',
      '3': '3px',
      '4': '4px',
      '6': '6px',
      '8': '8px',
    }
  }
}

To customize only the divide width values, use the theme.divideWidth section of your tailwind.config.js file.

tailwind.config.js
module.exports = {
  theme: {
    divideWidth: {
      DEFAULT: '1px',
      '0': '0',
      '2': '2px',
      '3': '3px',
      '4': '4px',
      '6': '6px',
      '8': '8px',
    }
  }
}

Learn more about customizing the default theme in the theme customization documentation.

Arbitrary values

If you need to use a one-off divide-{x|y}-{width} value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

<div class="divide-x-[3px]">
  <!-- ... -->
</div>

Learn more about arbitrary value support in the arbitrary values documentation.