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

# shortcutItems

The Home screen dynamic quick actions for your app; available on devices that support 3D Touch.

```
var shortcutItems: [UIApplicationShortcutItem]? { get set }
```

## Discussion

Set this property to register an array of dynamic quick actions to display on the Home screen when a user presses your app icon. Read this property to retrieve the currently registered Home screen dynamic quick actions.

The items in the `shortcutItems` array are instances of the [`UIApplicationShortcutItem`](/documentation/UIKit/UIApplicationShortcutItem) class, and are therefore immutable.

> Terminology: Dynamic vs. Static Quick Actions:
> The items in an application object’s `shortcutItems` array, although immutable, are considered *dynamic* to distinguish them from the *static* quick actions you can specify at build time in the [UIApplicationShortcutItems](https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW36) array in your Xcode project’s `Info.plist` file. You create dynamic quick actions, and register them with your application object, at runtime.

The system populates the displayed set of Home screen quick actions, starting at the top, first with your static quick actions. Only if there are additional positions available does it also show your dynamic quick actions, up to the system-defined limit.

The onscreen ordering of your Home screen quick actions reflects the ordering in your [UIApplicationShortcutItems](https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW36) array (if that array contains items) and the ordering of the items in the `shortcutItems` array (if any are displayed).

> Note:
> When you read the value of this property, you obtain an array that contains, exclusively, your *dynamic* Home screen quick actions. Any static quick actions you’ve defined are not represented in this property’s value.

---

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)