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

# secondaryButtonSubmenuItems

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

```
let secondaryButtonSubmenuItems: [String]?
```

## Discussion

When you provide this array, the system displays a submenu on secondary button taps. Add up to three array elements that correspond to custom actions your app implements, for example:

1. “1 more minute”
2. “15 more minutes”
3. “1 more hour”

Or, your app might tailor actions for an education app as:

1. “Finish this lesson.”
2. “Complete homework.”
3. “Take a quiz.”

To respond to menu item taps, implement [`ShieldAction.firstSecondarySubmenuItemPressed`](/documentation/ManagedSettings/ShieldAction/firstSecondarySubmenuItemPressed), [`ShieldAction.secondSecondarySubmenuItemPressed`](/documentation/ManagedSettings/ShieldAction/secondSecondarySubmenuItemPressed), and [`ShieldAction.thirdSecondarySubmenuItemPressed`](/documentation/ManagedSettings/ShieldAction/thirdSecondarySubmenuItemPressed), depending on the number of elements your app adds to the array.

If you provide `nil` or an empty array, the secondary button doesn’t display a submenu and instead invokes the [`ShieldAction.secondaryButtonPressed`](/documentation/ManagedSettings/ShieldAction/secondaryButtonPressed) action when a person presses the secondary button. The system automatically adds a Cancel button to dismiss the menu.

---

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)