---
title: backgroundConfiguration
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uicollectionviewcell/backgroundconfiguration-39dc0
---

# backgroundConfiguration

The current background configuration of the cell.

## Declaration

```occ
@property (nonatomic, copy, nullable) UIBackgroundConfiguration * backgroundConfiguration;
```

## Discussion

Discussion Using a background configuration, you can obtain system default background styling for a variety of different cell states. Create a background configuration with one of the default system styles, customize the configuration to match your cell’s style as needed, and assign the configuration to this property. UIBackgroundConfiguration *backgroundConfig = [UIBackgroundConfiguration listPlainCellConfiguration];

// Set a nil background color to use the view's tint color. [backgroundConfig setBackgroundColor:nil];

[cell setBackgroundConfiguration:backgroundConfig]; A background configuration is mutually exclusive with background views, so you must use one approach or the other. Setting a non-nil value for this property resets the following APIs to nil: backgroundColor backgroundView selectedBackgroundView

## See Also

### Configuring the background

- [defaultBackgroundConfiguration](uikit/uicollectionviewcell/defaultbackgroundconfiguration.md)
- [automaticallyUpdatesBackgroundConfiguration](uikit/uicollectionviewcell/automaticallyupdatesbackgroundconfiguration.md)
- [backgroundView](uikit/uicollectionviewcell/backgroundview.md)
- [selectedBackgroundView](uikit/uicollectionviewcell/selectedbackgroundview.md)