📄 tailwindcss/docs/background-origin

File: background-origin.md | Updated: 11/15/2025

Source: https://tailwindcss.com/docs/background-origin

v4.1

⌘KCtrl KDocs Blog Showcase Sponsor Plus

  1. Backgrounds
  2. background-origin

Backgrounds

background-origin

Utilities for controlling how an element's background is positioned relative to borders, padding, and content.

| Class | Styles | | --- | --- | | bg-origin-border | background-origin: border-box; | | bg-origin-padding | background-origin: padding-box; | | bg-origin-content | background-origin: content-box; |

Examples


Basic example

Use the bg-origin-border, bg-origin-padding, and bg-origin-content utilities to control where an element's background is rendered:

bg-origin-border

bg-origin-padding

bg-origin-content

<div class="border-4 bg-[url(/img/mountains.jpg)] bg-origin-border p-3 ..."></div><div class="border-4 bg-[url(/img/mountains.jpg)] bg-origin-padding p-3 ..."></div><div class="border-4 bg-[url(/img/mountains.jpg)] bg-origin-content p-3 ..."></div>

Responsive design

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

<div class="bg-origin-border md:bg-origin-padding ...">  <!-- ... --></div>

Learn more about using variants in the variants documentation .

On this page

Copyright © 2025 Tailwind Labs Inc.·Trademark Policy