Examples

Basic example

Use the bg-[<value>] syntax to set the background image of an element:

Adding a linear gradient

Use utilities like bg-linear-to-r and bg-linear-<angle> with the color stop utilities to add a linear gradient to an element:

Adding a radial gradient

Use the bg-radial and bg-radial-[<position>] utilities with the color stop utilities to add a radial gradient to an element:

Adding a conic gradient

Use the bg-conic and bg-conic-<angle> utilities with the color stop utilities to add a conic gradient to an element:

Setting gradient color stops

Use utilities like from-indigo-500, via-purple-500, and to-pink-500 to set the colors of the gradient stops:

Setting gradient stop positions

Use utilities like from-10%, via-30%, and to-90% to set more precise positions for the gradient color stops:

Changing interpolation mode

Use the interpolation modifier to control the interpolation mode of a gradient:

By default gradients are interpolated in the oklab color space.

Removing background images

Use the bg-none utility to remove an existing background image from an element:

<div class="bg-none"></div>

Using a custom value

Use utilities like bg-linear-[<value>] and from-[<value>] to set the gradient based on a completely custom value:

<div class="bg-linear-[25deg,red_5%,yellow_60%,lime_90%,teal] ...">
  <!-- ... -->
</div>

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

<div class="bg-linear-(--my-gradient) ...">
  <!-- ... -->
</div>

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

Responsive design

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

<div class="from-purple-400 md:from-yellow-500 ...">
  <!-- ... -->
</div>

Learn more about using variants in the variants documentation.

Customizing your theme

Use the --color-* theme variables to customize the color utilities in your project:

@theme {
  --color-regal-blue: #243c5a; 
}

Now utilities like from-regal-blue,via-regal-blue, and to-regal-blue can be used in your markup:

<div class="from-regal-blue">
  <!-- ... -->
</div>

Learn more about customizing your theme in the theme documentation.