# containerBackground(for:alignment:content:) Sets the container background of the enclosing container using a view. ``` nonisolated func containerBackground(for container: ContainerBackgroundPlacement, alignment: Alignment = .center, @ContentBuilder content: () -> V) -> some View where V : View ``` ## Parameters `container` The container that will use the background. `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` The view to use as the background of the container. ## Discussion The following example uses a custom [`View`](/documentation/SwiftUI/View) as a background: ``` struct ContentView: View { var body: some View { NavigationStack { List { NavigationLink("Image") { Text("Image") .containerBackground(for: .navigation) { Image(name: "ImageAsset") } } } } } } ``` The `.containerBackground(for:alignment:content:)` modifier differs from the [`background(_:ignoresSafeAreaEdges:)`](/documentation/SwiftUI/View/background(_:ignoresSafeAreaEdges:)) modifier by automatically filling an entire parent container. [`ContainerBackgroundPlacement`](/documentation/SwiftUI/ContainerBackgroundPlacement) describes the available containers. --- Copyright © 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)