Tailwind CSS v1.0 is here! Learn more →

Background Position

Utilities for controlling the position of an element's background image.

Work in progress!

More detailed documentation is coming soon, but in the meantime here's a quick class reference.

Class reference

Class Properties
.bg-bottom background-position: bottom;
.bg-center background-position: center;
.bg-left background-position: left;
.bg-left-bottom background-position: left bottom;
.bg-left-top background-position: left top;
.bg-right background-position: right;
.bg-right-bottom background-position: right bottom;
.bg-right-top background-position: right top;
.bg-top background-position: top;

Customizing

Responsive and State Variants

By default, only responsive variants are generated for background position utilities.

You can control which variants are generated for the background position utilities by modifying the backgroundPosition property in the modules section of your Tailwind config file.

For example, this config will also generate hover and focus variants:

{
// ...
modules: {
    // ...
-   backgroundPosition: ['responsive'],
+   backgroundPosition: ['responsive', 'hover', 'focus', 'active', 'group-hover'],
}
}

Disabling

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

{
// ...
modules: {
    // ...
-   backgroundPosition: ['responsive'],
+   backgroundPosition: false,
}
}