Tailwind CSS on GitHub

Background Opacity

Utilities for controlling the opacity of an element's background color.

Default class reference

Class
Properties
bg-opacity-0--tw-bg-opacity: 0;
bg-opacity-5--tw-bg-opacity: 0.05;
bg-opacity-10--tw-bg-opacity: 0.1;
bg-opacity-20--tw-bg-opacity: 0.2;
bg-opacity-25--tw-bg-opacity: 0.25;
bg-opacity-30--tw-bg-opacity: 0.3;
bg-opacity-40--tw-bg-opacity: 0.4;
bg-opacity-50--tw-bg-opacity: 0.5;
bg-opacity-60--tw-bg-opacity: 0.6;
bg-opacity-70--tw-bg-opacity: 0.7;
bg-opacity-75--tw-bg-opacity: 0.75;
bg-opacity-80--tw-bg-opacity: 0.8;
bg-opacity-90--tw-bg-opacity: 0.9;
bg-opacity-95--tw-bg-opacity: 0.95;
bg-opacity-100--tw-bg-opacity: 1;

Usage

Control the opacity of an element's background color using the bg-opacity-{amount} utilities.

100%
75%
50%
25%
0%
<div class="bg-indigo-600 bg-opacity-100 ..."></div>
<div class="bg-indigo-600 bg-opacity-75 ..."></div>
<div class="bg-indigo-600 bg-opacity-50 ..."></div>
<div class="bg-indigo-600 bg-opacity-25 ..."></div>
<div class="bg-indigo-600 bg-opacity-0 ..."></div>

Responsive

To control an element's background color opacity at a specific breakpoint, add a {screen}: prefix to any existing background color opacity utility. For example, use md:bg-opacity-50 to apply the bg-opacity-50 utility at only medium screen sizes and above.

<div class="bg-blue-500 bg-opacity-75 md:bg-opacity-50">
  <!-- ... -->
</div>

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

Customizing

To customize the opacity values for all opacity-related utilities at once, use the opacity section of your tailwind.config.js theme configuration:

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        opacity: {
+         '15': '0.15',
+         '35': '0.35',
+         '65': '0.65',
        }
      }
    }
  }

If you want to customize only the background opacity utilities, use the backgroundOpacity section:

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        backgroundOpacity: {
+         '10': '0.1',
+         '20': '0.2',
+         '95': '0.95',
        }
      }
    }
  }

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

Variants

By default, only responsive, group-hover, focus-within, hover and focus variants are generated for background opacity utilities.

You can control which variants are generated for the background opacity utilities by modifying the backgroundOpacity property in the variants section of your tailwind.config.js file.

For example, this config will also generate active variants:

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       backgroundOpacity: ['active'],
      }
    }
  }

Disabling

If you don't plan to use the background opacity utilities in your project, you can disable them entirely by setting the backgroundOpacity property to false in the corePlugins section of your config file:

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