background-position

Examples

Basic example

Use utilities like bg-center, bg-right, and bg-left-top to control the position of an element's background image:

Hover over these examples to see the full image

bg-left-top

bg-top

bg-right-top

bg-left

bg-center

bg-right

bg-left-bottom

bg-bottom

bg-right-bottom

<div class="bg-[url(/img/mountains.jpg)] bg-left-top"></div><div class="bg-[url(/img/mountains.jpg)] bg-top"></div><div class="bg-[url(/img/mountains.jpg)] bg-right-top"></div><div class="bg-[url(/img/mountains.jpg)] bg-left"></div><div class="bg-[url(/img/mountains.jpg)] bg-center"></div><div class="bg-[url(/img/mountains.jpg)] bg-right"></div><div class="bg-[url(/img/mountains.jpg)] bg-left-bottom"></div><div class="bg-[url(/img/mountains.jpg)] bg-bottom"></div><div class="bg-[url(/img/mountains.jpg)] bg-right-bottom"></div>

Using a custom value

Use the bg-[<value>] syntax to set the background position based on a completely custom value:

<div class="bg-[center_top_1rem] ...">  <!-- ... --></div>

For CSS variables, you can also use the bg-(position:<custom-property>) syntax:

<div class="bg-(position:--my-bg-position) ...">  <!-- ... --></div>

This is just a shorthand for bg-[position:var(<custom-property>)] that adds the var() function for you automatically.

Responsive design

Prefix a background-position utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:

<div class="bg-center md:bg-top ...">  <!-- ... --></div>

Learn more about using variants in the variants documentation.