<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/View/background(alignment:content:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI4ViewPAAE10background9alignment7contentQrAA9AlignmentV_qd__yXEtAaBRd__lF"
  },
  "title" : "background(alignment:content:)"
}
-->

# background(alignment:content:)

Layers the views that you specify behind this view.

```
nonisolated func background<V>(alignment: Alignment = .center, @ContentBuilder content: () -> V) -> some View where V : View
```

## Parameters

`alignment`

The alignment that the modifier uses to position the
implicit [`ZStack`](/documentation/SwiftUI/ZStack) that groups the background views. The default
is [`center`](/documentation/SwiftUI/Alignment/center).

`content`

A [`ContentBuilder`](/documentation/SwiftUI/ContentBuilder) that you use to declare the views to draw
behind this view, stacked in a cascading order from bottom to top.
The last view that you list appears at the front of the stack.

## Return Value

A view that uses the specified content as a background.

## Discussion

Use this modifier to place one or more views behind another view.
For example, you can place a collection of stars behind a [`Text`](/documentation/SwiftUI/Text) view:

```
Text("ABCDEF")
    .background(alignment: .leading) { Star(color: .red) }
    .background(alignment: .center) { Star(color: .green) }
    .background(alignment: .trailing) { Star(color: .blue) }
```

The example above assumes that you’ve defined a `Star` view with a
parameterized color:

```
struct Star: View {
    var color: Color

    var body: some View {
        Image(systemName: "star.fill")
            .foregroundStyle(color)
    }
}
```

By setting different `alignment` values for each modifier, you make the
stars appear in different places behind the text:

![A screenshot of the letters A, B, C, D, E, and F written in front of](images/com.apple.SwiftUI/View-background-2@2x.png)

If you specify more than one view in the `content` closure, the modifier
collects all of the views in the closure into an implicit [`ZStack`](/documentation/SwiftUI/ZStack),
taking them in order from back to front. For example, you can layer a
vertical bar behind a circle, with both of those behind a horizontal
bar:

```
Color.blue
    .frame(width: 200, height: 10) // Creates a horizontal bar.
    .background {
        Color.green
            .frame(width: 10, height: 100) // Creates a vertical bar.
        Circle()
            .frame(width: 50, height: 50)
    }
```

Both the background modifier and the implicit [`ZStack`](/documentation/SwiftUI/ZStack) composed from
the background content — the circle and the vertical bar — use a
default [`center`](/documentation/SwiftUI/Alignment/center) alignment. The vertical bar appears
centered behind the circle, and both appear as a composite view centered
behind the horizontal bar:

![A screenshot of a circle with a horizontal blue bar layered on top](images/com.apple.SwiftUI/View-background-3@2x.png)

If you specify an alignment for the background, it applies to the
implicit stack rather than to the individual views in the closure. You
can see this if you add the [`leading`](/documentation/SwiftUI/Alignment/leading) alignment:

```
Color.blue
    .frame(width: 200, height: 10)
    .background(alignment: .leading) {
        Color.green
            .frame(width: 10, height: 100)
        Circle()
            .frame(width: 50, height: 50)
    }
```

The vertical bar and the circle move as a unit to align the stack
with the leading edge of the horizontal bar, while the
vertical bar remains centered on the circle:

![A screenshot of a horizontal blue bar in front of a circle, which](images/com.apple.SwiftUI/View-background-3a@2x.png)

To control the placement of individual items inside the `content`
closure, either use a different background modifier for each item, as
the earlier example of stars under text demonstrates, or add an explicit
[`ZStack`](/documentation/SwiftUI/ZStack) inside the content closure with its own alignment:

```
Color.blue
    .frame(width: 200, height: 10)
    .background(alignment: .leading) {
        ZStack(alignment: .leading) {
            Color.green
                .frame(width: 10, height: 100)
            Circle()
                .frame(width: 50, height: 50)
        }
    }
```

The stack alignment ensures that the circle’s leading edge aligns with
the vertical bar’s, while the background modifier aligns the composite
view with the horizontal bar:

![A screenshot of a horizontal blue bar in front of a circle, which](images/com.apple.SwiftUI/View-background-4@2x.png)

You can achieve layering without a background modifier by putting both
the modified view and the background content into a [`ZStack`](/documentation/SwiftUI/ZStack). This
produces a simpler view hierarchy, but it changes the layout priority
that SwiftUI applies to the views. Use the background modifier when you
want the modified view to dominate the layout.

If you want to specify a [`ShapeStyle`](/documentation/SwiftUI/ShapeStyle) like a
[`HierarchicalShapeStyle`](/documentation/SwiftUI/HierarchicalShapeStyle) or a [`Material`](/documentation/SwiftUI/Material) as the background, use
[`background(_:ignoresSafeAreaEdges:)`](/documentation/SwiftUI/View/background(_:ignoresSafeAreaEdges:)) instead.
To specify a [`Shape`](/documentation/SwiftUI/Shape) or [`InsettableShape`](/documentation/SwiftUI/InsettableShape), use
[`background(_:in:fillStyle:)`](/documentation/SwiftUI/View/background(_:in:fillStyle:)).
To configure the background of a presentation, like a sheet, use
[`presentationBackground(alignment:content:)`](/documentation/SwiftUI/View/presentationBackground(alignment:content:)).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)