<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: -"
  ],
  "documentType" : "symbol",
  "framework" : "ManagedSettings",
  "identifier" : "/documentation/ManagedSettingsUI/ShieldConfiguration",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Managed Settings UI"
    ],
    "preciseIdentifier" : "s:17ManagedSettingsUI19ShieldConfigurationV"
  },
  "title" : "ShieldConfiguration"
}
-->

# ShieldConfiguration

An object that defines the appearance of a shield to display over an application or website.

```
struct ShieldConfiguration
```

## Overview

The system provides a default appearance for any properties you set to `nil`.

## Topics

### Initializing a shield configuration

[`init(backgroundBlurStyle:backgroundColor:icon:title:subtitle:primaryButtonLabel:primaryButtonBackgroundColor:secondaryButtonLabel:)`](/documentation/ManagedSettingsUI/ShieldConfiguration/init(backgroundBlurStyle:backgroundColor:icon:title:subtitle:primaryButtonLabel:primaryButtonBackgroundColor:secondaryButtonLabel:))

Creates a shield configuration with the specified values.

[`init(backgroundBlurStyle:backgroundColor:icon:title:subtitle:primaryButtonLabel:primaryButtonBackgroundColor:secondaryButtonLabel:secondaryButtonSubmenuItems:)`](/documentation/ManagedSettingsUI/ShieldConfiguration/init(backgroundBlurStyle:backgroundColor:icon:title:subtitle:primaryButtonLabel:primaryButtonBackgroundColor:secondaryButtonLabel:secondaryButtonSubmenuItems:))

Initializes a shield configuration with optional submenu items for the secondary button.

### Configure the visual style

[`backgroundBlurStyle`](/documentation/ManagedSettingsUI/ShieldConfiguration/backgroundBlurStyle)

A blur style to apply to the background of the shield.

[`backgroundColor`](/documentation/ManagedSettingsUI/ShieldConfiguration/backgroundColor)

A color for a shield to use in the background blur effect.

[`icon`](/documentation/ManagedSettingsUI/ShieldConfiguration/icon)

An icon to display in the center of the shield.

### Configure the text content

[`title`](/documentation/ManagedSettingsUI/ShieldConfiguration/title)

The title of the shield to display below the icon.

[`subtitle`](/documentation/ManagedSettingsUI/ShieldConfiguration/subtitle)

The subtitle for a shield to display below the title.

[`ShieldConfiguration.Label`](/documentation/ManagedSettingsUI/ShieldConfiguration/Label)

The appearance of text labels within a shield.

### Configure the primary button

[`primaryButtonLabel`](/documentation/ManagedSettingsUI/ShieldConfiguration/primaryButtonLabel)

The label of the topmost rounded rectangle button.

[`primaryButtonBackgroundColor`](/documentation/ManagedSettingsUI/ShieldConfiguration/primaryButtonBackgroundColor)

The color to fill the contents of the rounded rectangle primary button.

### Configure the secondary button

[`secondaryButtonLabel`](/documentation/ManagedSettingsUI/ShieldConfiguration/secondaryButtonLabel)

The label of the optional secondary button.

[`secondaryButtonSubmenuItems`](/documentation/ManagedSettingsUI/ShieldConfiguration/secondaryButtonSubmenuItems)

An array of strings that define the items to display in the secondary button’s submenu.


---

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)