Skip to content

Backgrounds

Background Position

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

Quick reference

ClassDescription
bg-bottombackground-position: bottom
bg-centerbackground-position: center
bg-leftbackground-position: left
bg-left-bottombackground-position: left bottom
bg-left-topbackground-position: left top
bg-rightbackground-position: right
bg-right-bottombackground-position: right bottom
bg-right-topbackground-position: right top
bg-topbackground-position: top

Basic usage

Setting the background position

Use the bg-{side} utilities to control the position of an element’s background image.

bg-left-top
bg-top
bg-right-top
bg-left
bg-center
bg-right
bg-left-bottom
bg-bottom
bg-right-bottom
html
<div class="bg-left-top ..."></div>
<div class="bg-top ..."></div>
<div class="bg-right-top ..."></div>
<div class="bg-left ..."></div>
<div class="bg-center ..."></div>
<div class="bg-right ..."></div>
<div class="bg-left-bottom ..."></div>
<div class="bg-bottom ..."></div>
<div class="bg-right-bottom ..."></div>

Arbitrary values

If you need to use a one-off background-position value, use square brackets to generate a property on the fly using any arbitrary value.

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

Applying conditionally

Hover, focus, and other states

Warp lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:bg-top to only apply the bg-top utility on hover.

html
<div class="bg-center hover:bg-top ..."></div>

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:bg-top to apply the bg-top utility at only medium screen sizes and above.

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