# containerBackground(_:for:) Sets the container background of the enclosing container using a view. ``` nonisolated func containerBackground(_ style: S, for container: ContainerBackgroundPlacement) -> some View where S : ShapeStyle ``` ## Discussion The following example uses a [`LinearGradient`](/documentation/SwiftUI/LinearGradient) as a background: ``` struct ContentView: View { var body: some View { NavigationStack { List { NavigationLink("Blue") { Text("Blue") .containerBackground(.blue.gradient, for: .navigation) } NavigationLink("Red") { Text("Red") .containerBackground(.red.gradient, for: .navigation) } } } } } ``` The `.containerBackground(_:for:)` 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. - Parameters - style: The shape style to use as the container background. - container: The container that will use the background. --- 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)