.background()

iOS 13+

Layers a view behind the current view, useful for adding colors, gradients, images, or custom views as backgrounds.

Visual Effects
Official Apple Documentation →
iOS User Coverage
97.2%
coverage

97.2% of iOS users can use this modifier

Version Compatibility
iOS 18.7
30.3% Supported
iOS 18.6
29.8% Supported
iOS 26.1
10.7% Supported
iOS 18.5
6.0% Supported
iOS 16.7
2.3% Supported
iOS 26.2
2.0% Supported
iOS 18.3
1.8% Supported
iOS 15.8
1.8% Supported
iOS 17.6
1.7% Supported
iOS 26.0
1.3% Supported

iOS 13+ required

Variants
.background(_:)

Sets a view or shape as the background

Parameters:
  • content: View or ShapeStyle
.background(_:ignoresSafeAreaEdges:)

Sets background that can extend into safe area

Parameters:
  • content: View or ShapeStyle
  • edges: Edge.Set
Code Examples

Color Background

Add a solid color background

Text("Hello, World!")
    .padding()
    .background(.blue)

Gradient Background

Use a linear gradient as background

Text("Hello, World!")
    .padding()
    .background(
        LinearGradient(
            colors: [.blue, .purple],
            startPoint: .top,
            endPoint: .bottom
        )
    )

Custom View Background

Layer a rounded rectangle behind content

Text("Hello, World!")
    .padding()
    .background(
        RoundedRectangle(cornerRadius: 10)
            .fill(.blue.opacity(0.2))
    )

Loading related modifiers...

Frequently Asked Questions

What iOS version is required for .background()?

The .background() modifier requires iOS 13 or later. This means 97.2% of current iOS users can use this modifier.

How do I use .background() in SwiftUI?

Apply the .background() modifier to any SwiftUI view. Check the code examples above for usage patterns.

Where can I learn more?

Visit the official Apple documentation for detailed information.

Explore More SwiftUI Modifiers

Browse All Modifiers iOS Frameworks