Quick reference

Class
Properties
will-change-autowill-change: auto;
will-change-scrollwill-change: scroll-position;
will-change-contentswill-change: contents;
will-change-transformwill-change: transform;

Basic usage

Optimizing with will change

Use will-change-scroll, will-change-contents and will-change-transform to optimize an element that’s expected to change in the near future by instructing the browser to prepare the necessary animation before it actually begins.

<div class="overflow-auto will-change-scroll">
  <!-- ... -->
</div>

It’s recommended that you apply these utilities just before an element changes, and then remove it shortly after it finishes using will-change-auto.

The will-change property is intended to be used as a last resort when dealing with known performance problems. Avoid using these utilities too much, or simply in anticipation of performance issues, as it could actually cause the page to be less performant.


Applying conditionally

Hover, focus, and other states

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

<div class="will-change-auto hover:will-change-scroll">
  <!-- ... -->
</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:will-change-scroll to apply the will-change-scroll utility at only medium screen sizes and above.

<div class="will-change-auto md:will-change-scroll">
  <!-- ... -->
</div>

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


Using custom values

Customizing your theme

By default, Tailwind provides four will-change utilities. You can customize these values by editing theme.willChange or theme.extend.willChange in your tailwind.config.js file.

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      willChange: {
        'left-top': 'left, top',
      }
    }
  }
}

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

Arbitrary values

If you need to use a one-off will-change 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="will-change-[top,left]">
  <!-- ... -->
</div>

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