Background

Source: https://getbootstrap.com/docs/6.0/utilities/background

Convey meaning through background-color and add decoration with gradients.

Colors

Change the background-color using utilities built on our theme colors using .bg-{color}, .bg-muted-{color}, and .bg-subtle-{color}. All these background color utilities set the background-color property to a local CSS variable, --bs-bg, which has the value of the theme color. The root color tokens also use light-dark() to ensure sufficient contrast in both light and dark color modes.

For example, .bg-primary sets the --bs-bg variable to var(--bs-primary-bg):

.bg-primary {
  --bs-bg: var(--bs-primary-bg);
  background-color: var(--bs-bg);
}

This approach allows us to also easily support translucency with our .bg-{opacity} utilities as we can use color-mix() with the CSS variable to generate the appropriate color. See the opacity section for more details.

<Example code={[ ...getData('theme-colors').map((themeColor) => &lt;div class="p-3 mb-2 bg-${themeColor.name} fg-contrast-${themeColor.name}">.bg-${themeColor.name}&lt;/div> &lt;div class="p-3 mb-2 bg-muted-${themeColor.name} fg-${themeColor.name}">.bg-muted-${themeColor.name}&lt;/div> &lt;div class="p-3 mb-2 bg-subtle-${themeColor.name} fg-${themeColor.name}">.bg-subtle-${themeColor.name}&lt;/div>), &lt;div class="p-3 mb-2 bg-body fg-body">.bg-body&lt;/div> &lt;div class="p-3 mb-2 bg-1">.bg-1&lt;/div> &lt;div class="p-3 mb-2 bg-2">.bg-2&lt;/div> &lt;div class="p-3 mb-2 bg-3">.bg-3&lt;/div> &lt;div class="p-3 mb-2 bg-4">.bg-4&lt;/div> &lt;div class="p-3 mb-2 bg-black fg-white">.bg-black&lt;/div> &lt;div class="p-3 mb-2 bg-white fg-black">.bg-white&lt;/div> &lt;div class="p-3 mb-2 bg-transparent fg-body">.bg-transparent&lt;/div> ]} />

Background gradient

By adding a .bg-gradient class, a linear gradient is added as background image to the backgrounds. This gradient starts with a semi-transparent white which fades out to the bottom.

Do you need a gradient in your custom CSS? Just add background-image: var(--bs-gradient);.

<Example class="d-flex flex-column gap-2" code={[ ...getData('theme-colors').map((themeColor) => <div class="p-3 bg-${themeColor.name} bg-gradient fg-contrast-${themeColor.name}">.bg-${themeColor.name}.bg-gradient</div>), <div class="p-3 bg-black bg-gradient fg-white">.bg-black.bg-gradient</div> ]} />

Opacity

Change the opacity of a background color by using any of the .bg-<percentage> utilities which use color-mix() to mix the background color with transparent.

<Example class="d-flex flex-column gap-2" code={&lt;div class="bg-success p-2">This is default success background&lt;/div> &lt;div class="bg-success p-2 bg-90">This is 90% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-80">This is 80% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-70">This is 70% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-60">This is 60% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-50">This is 50% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-40">This is 40% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-30">This is 30% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-20">This is 20% opacity success background&lt;/div> &lt;div class="bg-success p-2 bg-10">This is 10% opacity success background&lt;/div>} />

The same can be applied to subtle and muted background colors.

<Example class="d-flex flex-column gap-2" code={&lt;div class="bg-subtle-success p-2">This is subtle success background&lt;/div> &lt;div class="bg-muted-success bg-40 p-2">This is 40% success background&lt;/div> &lt;div class="bg-muted-success bg-20 p-2">This is 20% success background&lt;/div>} />

CSS

In addition to the following Sass functionality, consider reading about our included CSS custom properties (aka CSS variables) for colors and more.

Sass variables

Most background-color utilities are generated by our theme colors, reassigned from our generic color palette variables. Grayscale colors are also available, but only a subset are used to generate any utilities. See the Color documentation for our base color variables and map.

Sass maps

Theme colors are then put into a Sass map so we can loop over them to generate our utilities, component modifiers, and more. See the Theme documentation for the full $theme-colors Sass map.

Sass mixins

No mixins are used to generate our background utilities, but we do have some additional mixins for other situations where you’d like to create your own gradients.

Sass utilities API

Background utilities are declared in our utilities API in scss/_utilities.scss. Learn how to use the utilities API.