---
title: automaticallyUpdatesBackgroundConfiguration
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uicollectionviewcell/automaticallyupdatesbackgroundconfiguration
---

# automaticallyUpdatesBackgroundConfiguration

A Boolean value that determines whether the cell automatically updates its background configuration when its state changes.

## Declaration

```swift
var automaticallyUpdatesBackgroundConfiguration: Bool { get set }
```

## Discussion

Discussion When this value is true, the cell automatically calls updated(for:) on its backgroundConfiguration when the cell’s configurationState changes, and applies the updated configuration back to the cell. The default value is true. If you override updateConfiguration(using:) to manually update and customize the background configuration, disable automatic updates by setting this property to false.

## See Also

### Configuring the background

- [defaultBackgroundConfiguration()](uikit/uicollectionviewcell/defaultbackgroundconfiguration().md)
- [backgroundConfiguration](uikit/uicollectionviewcell/backgroundconfiguration-rgj4.md)
- [backgroundView](uikit/uicollectionviewcell/backgroundview.md)
- [selectedBackgroundView](uikit/uicollectionviewcell/selectedbackgroundview.md)
