Border Width

Utilities for controlling the width of an element’s borders.

Class reference

All sides

Use the .border, .border-0, .border-2, .border-4, or .border-8 utilities to set the border width for all sides of an element.

<div class="border-0 border-gray-600 ..."></div>
<div class="border border-gray-600 ..."></div>
<div class="border-2 border-gray-600 ..."></div>
<div class="border-4 border-gray-600 ..."></div>
<div class="border-8 border-gray-600 ..."></div>

Individual sides

Use the .border-{side}, .border-{side}-0, .border-{side}-2, .border-{side}-4, or .border-{side}-8 utilities to set the border width for one side of an element.

<div class="border-t-2 border-gray-600 ..."></div>
<div class="border-r-2 border-gray-600 ..."></div>
<div class="border-b-2 border-gray-600 ..."></div>
<div class="border-l-2 border-gray-600 ..."></div>

Between elementsv1.3.0+

You can also add borders between child elements using the divide-{x/y}-{width} and divide-{color} utilities.

Learn more in the Divide Width and Divide Color documentation.

<div class="divide-y divide-gray-400">
  <div class="text-center py-2">1</div>
  <div class="text-center py-2">2</div>
  <div class="text-center py-2">3</div>
</div>

Responsive

To control the border width of an element at a specific breakpoint, add a {screen}: prefix to any existing border width utility. For example, use md:border-t-4 to apply the border-t-4 utility at only medium screen sizes and above.

For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.

all

sm

md

lg

xl

<div class="border-2 sm:border-t-8 md:border-r-8 lg:border-b-8 xl:border-8">
</div>

Customizing

Border Widths

By default Tailwind provides five border-width utilities, and the same number of utilities per side (top, right, bottom, and left). You change, add, or remove these by editing the theme.borderWidth section of your Tailwind config. The values in this section will also control which utilities will be generated side.

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

Responsive and pseudo-class variants

By default, only responsive variants are generated for border width utilities.

You can control which variants are generated for the border width utilities by modifying the borderWidth 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: {
      // ...
-     borderWidth: ['responsive'],
+     borderWidth: ['responsive', 'hover', 'focus'],
    }
  }

Disabling

If you don’t plan to use the border width utilities in your project, you can disable them entirely by setting the borderWidth property to false in the corePlugins section of your config file:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     borderWidth: false,
    }
  }

← Border Radius   Border Color →