📄 tailwindcss/docs/background-repeat

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

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

v4.1

⌘KCtrl KDocs Blog Showcase Sponsor Plus

  1. Backgrounds
  2. background-repeat

Backgrounds

background-repeat

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

| Class | Styles | | --- | --- | | bg-repeat | background-repeat: repeat; | | bg-repeat-x | background-repeat: repeat-x; | | bg-repeat-y | background-repeat: repeat-y; | | bg-repeat-space | background-repeat: space; | | bg-repeat-round | background-repeat: round; | | bg-no-repeat | background-repeat: no-repeat; |

Examples


Basic example

Use the bg-repeat utility to repeat the background image both vertically and horizontally:

<div class="bg-[url(/img/clouds.svg)] bg-center bg-repeat ..."></div>

Repeating horizontally

Use the bg-repeat-x utility to only repeat the background image horizontally:

<div class="bg-[url(/img/clouds.svg)] bg-center bg-repeat-x ..."></div>

Repeating vertically

Use the bg-repeat-y utility to only repeat the background image vertically:

<div class="bg-[url(/img/clouds.svg)] bg-center bg-repeat-y ..."></div>

Preventing clipping

Use the bg-repeat-space utility to repeat the background image without clipping:

<div class="bg-[url(/img/clouds.svg)] bg-center bg-repeat-space ..."></div>

Preventing clipping and gaps

Use the bg-repeat-round utility to repeat the background image without clipping, stretching if needed to avoid gaps:

<div class="bg-[url(/img/clouds.svg)] bg-center bg-repeat-round ..."></div>

Disabling repeating

Use the bg-no-repeat utility to prevent a background image from repeating:

<div class="bg-[url(/img/clouds.svg)] bg-center bg-no-repeat ..."></div>

Responsive design

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

<div class="bg-repeat md:bg-repeat-x ...">  <!-- ... --></div>

Learn more about using variants in the variants documentation .

On this page

Copyright © 2025 Tailwind Labs Inc.·Trademark Policy