.backgroundExtensionEffect()

iOS 26+

Duplicates a view into mirrored copies around its edges, creating an extended background effect.

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

14.1% of iOS users can use this modifier

Version Compatibility
iOS 26.1
10.7% Supported
iOS 26.2
2.0% Supported
iOS 26.0
1.3% Supported

iOS 26+ required

Variants
.backgroundExtensionEffect()

Creates mirrored edge extensions

Code Examples

Extended Background

Extend an image background beyond its bounds

Image("photo")
    .resizable()
    .aspectRatio(contentMode: .fit)
    .backgroundExtensionEffect()

Conditional Availability (iOS 26+)

Apply background extension with fallback for older iOS

Image("photo")
    .resizable()
    .aspectRatio(contentMode: .fit)
    .modifier(BackgroundExtension())

struct BackgroundExtension: ViewModifier {
    func body(content: Content) -> some View {
        if #available(iOS 26, *) {
            content.backgroundExtensionEffect()
        } else {
            content
        }
    }
}

Loading related modifiers...

Using with Older iOS Versions

If your app supports iOS versions older than 26, you can use #available to conditionally apply this modifier:

if #available(iOS 26, *) {
    myView.backgroundExtensionEffect()
} else {
    // Fallback for older iOS versions
    myView
}

Check the code examples above for specific #available patterns with this modifier.

Frequently Asked Questions

What iOS version is required for .backgroundExtensionEffect()?

The .backgroundExtensionEffect() modifier requires iOS 26 or later. This means 14.1% of current iOS users can use this modifier.

Can I use this if my app supports older iOS versions?

Yes! Use #available(iOS 26, *) to conditionally apply this modifier only on devices running iOS 26 or later, with a fallback for older versions.

How do I use .backgroundExtensionEffect() in SwiftUI?

Apply the .backgroundExtensionEffect() 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