<!--
{
  "availability" : [
    "iOS: 8.0.0 -",
    "iPadOS: 8.0.0 -",
    "macCatalyst: 13.1.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIVibrancyEffect",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIVibrancyEffect"
  },
  "title" : "UIVibrancyEffect"
}
-->

# UIVibrancyEffect

An object that amplifies and adjusts the color of the content layered behind a visual effect view.

```
@MainActor class UIVibrancyEffect
```

## Overview

A vibrancy effect is intended to be used as a subview of or layered on top of a [`UIVisualEffectView`](/documentation/UIKit/UIVisualEffectView) that has been configured with a [`UIBlurEffect`](/documentation/UIKit/UIBlurEffect). The use of a vibrancy effect can help the content placed inside the [`contentView`](/documentation/UIKit/UIVisualEffectView/contentView) become more vivid.

The vibrancy effect is color-dependent. Any subviews that you add to the [`contentView`](/documentation/UIKit/UIVisualEffectView/contentView) must implement the [`tintColorDidChange()`](/documentation/UIKit/UIView/tintColorDidChange()) method and update themselves accordingly. [`UIImageView`](/documentation/UIKit/UIImageView) objects with images that have a rendering mode of [`UIImage.RenderingMode.alwaysTemplate`](/documentation/UIKit/UIImage/RenderingMode-swift.enum/alwaysTemplate) as well as [`UILabel`](/documentation/UIKit/UILabel) objects update automatically.

## Topics

### Creating a vibrancy effect

[`init(forBlurEffect:style:)`](/documentation/UIKit/UIVibrancyEffect/init(forBlurEffect:style:))

Creates a vibrancy effect with the specified blur and style values.

[`init(blurEffect:)`](/documentation/UIKit/UIVibrancyEffect/init(blurEffect:))

Creates a vibrancy effect for a specific blur effect.

[`UIVibrancyEffectStyle`](/documentation/UIKit/UIVibrancyEffectStyle)

Constants for the vibrancy styles.

### Deprecated

[`widgetPrimary()`](/documentation/UIKit/UIVibrancyEffect/widgetPrimary())

Creates a vibrancy effect suitable for use with certain supporting text and template images within a widget.

[`widgetSecondary()`](/documentation/UIKit/UIVibrancyEffect/widgetSecondary())

Creates a vibrancy effect suitable for indicating the secondary importance or relevance of supporting text and template images within a widget.

[`widgetEffect(forVibrancyStyle:)`](/documentation/UIKit/UIVibrancyEffect/widgetEffect(forVibrancyStyle:))

Creates a vibrancy effect for the specified style.

[`notificationCenter()`](/documentation/UIKit/UIVibrancyEffect/notificationCenter())

Creates a vibrancy effect for use in Notification Center.


---

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)