--- description: Capacitor plugin to create app shortcuts on Android and iOS, allowing users to quickly access specific app functionalities. title: Capacitor App Shortcuts Plugin for Android & iOS - Capawesome image: https://capawesome.io/docs/assets/images/social/plugins/app-shortcuts.png --- [ Skip to content](#capawesomecapacitor-app-shortcuts) [ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) * [ Demo ](#demo) * [ Usage ](#usage) * [ API ](#api) * [ Changelog ](#changelog) * [ License ](#license) * [ App Update ](/docs/plugins/app-update/) * [ Apple Sign-In ](/docs/plugins/apple-sign-in/) * [ Asset Manager ](/docs/plugins/asset-manager/) * [ Audio Player ](/docs/plugins/audio-player/) * [ Audio Recorder ](/docs/plugins/audio-recorder/) * [ Background Task ](/docs/plugins/background-task/) * [ Badge ](/docs/plugins/badge/) * [ Barometer ](/docs/plugins/barometer/) * [ Biometrics ](/docs/plugins/biometrics/) * [ Bluetooth Low Energy ](/docs/plugins/bluetooth-low-energy/) * [ Cloudinary ](/docs/plugins/cloudinary/) * [ Contacts ](/docs/plugins/contacts/) * [ Datetime Picker ](/docs/plugins/datetime-picker/) * [ File Compressor ](/docs/plugins/file-compressor/) * [ File Opener ](/docs/plugins/file-opener/) * [ File Picker ](/docs/plugins/file-picker/) * [ Firebase ](/docs/plugins/firebase/) * [ Formbricks ](/docs/plugins/formbricks/) * [ Geocoder ](/docs/plugins/geocoder/) * [ Google Sign-In ](/docs/plugins/google-sign-in/) * [ libSQL ](/docs/plugins/libsql/) * [ Live Update ](/docs/plugins/live-update/) * [ Managed Configurations ](/docs/plugins/managed-configurations/) * [ Media Session ](/docs/plugins/media-session/) * [ ML Kit ](/docs/plugins/mlkit/) * [ NFC ](/docs/plugins/nfc/) * [ OAuth ](/docs/plugins/oauth/) * [ Pedometer ](/docs/plugins/pedometer/) * [ Photo Editor ](/docs/plugins/photo-editor/) * [ PostHog ](/docs/plugins/posthog/) * [ Printer ](/docs/plugins/printer/) * [ Purchases ](/docs/plugins/purchases/) * [ RealtimeKit ](/docs/plugins/realtimekit/) * [ Screen Orientation ](/docs/plugins/screen-orientation/) * [ Screenshot ](/docs/plugins/screenshot/) * [ Secure Preferences ](/docs/plugins/secure-preferences/) * [ Speech Recognition ](/docs/plugins/speech-recognition/) * [ Speech Synthesis ](/docs/plugins/speech-synthesis/) * [ Share Target ](/docs/plugins/share-target/) * [ Square Mobile Payments ](/docs/plugins/square-mobile-payments/) * [ SQLite ](/docs/plugins/sqlite/) * [ Superwall ](/docs/plugins/superwall/) * [ Torch ](/docs/plugins/torch/) * [ Wifi ](/docs/plugins/wifi/) * [ Zip ](/docs/plugins/zip/) * [ Cloud ](/docs/cloud/) * [ Live Updates ](/docs/cloud/live-updates/) * Advanced * Integrations * [ Native Builds ](/docs/cloud/native-builds/) * [ Configuration ](/docs/cloud/native-builds/configuration/) * [ Environments ](/docs/cloud/native-builds/environments/) * Guides * [ Sample Projects ](/docs/cloud/native-builds/sample-projects/) * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ Automations ](/docs/cloud/automations/) * [ Assist ](/docs/cloud/assist/) * Account * Organizations * [ Organization and User Management ](/docs/cloud/organizations/memberships/) * [ Single Sign-On (SSO) ](/docs/cloud/organizations/sso/) * [ Teams ](/docs/cloud/organizations/teams/) * [ Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/) * [ Integrations ](/docs/cloud/integrations/) * [ License Keys ](/docs/cloud/license-keys/) * [ Webhooks ](/docs/cloud/webhooks/) * [ Pricing ](https://capawesome.io/pricing/) * [ FAQ ](/docs/cloud/faq/) * [ Support ](/docs/cloud/support/) * [ Contributing ](/docs/contributing/) * [ LLMs ](/docs/llms/) * [ Insiders ](/docs/insiders/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/insiders/support/) * [ FAQ ](/docs/insiders/faq/) * [ Blog ](/blog/) * Categories * [ Demo ](#demo) * [ Usage ](#usage) * [ API ](#api) * [ Changelog ](#changelog) * [ License ](#license) # @capawesome/capacitor-app-shortcuts[¶](#capawesomecapacitor-app-shortcuts "Permanent link") Capacitor plugin to manage app shortcuts and quick actions. [ ![Deliver Live Updates to your Capacitor app with Capawesome Cloud](../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) ## Newsletter[¶](#newsletter "Permanent link") Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/). ## Compatibility[¶](#compatibility "Permanent link") | Plugin Version | Capacitor Version | Status | | -------------- | ----------------- | -------------- | | 8.x.x | \>=8.x.x | Active support | ## Installation[¶](#installation "Permanent link") You can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command: `[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-plugins ` Then use the following prompt: `` [](#%5F%5Fcodelineno-1-1) Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-app-shortcuts` plugin in my project. `` If you prefer **Manual Setup**, install the plugin by running the following commands: `[](#%5F%5Fcodelineno-2-1)npm install @capawesome/capacitor-app-shortcuts [](#%5F%5Fcodelineno-2-2)npx cap sync ` ## Configuration[¶](#configuration "Permanent link") | Prop | Type | Description | Since | | ------------- | ------------ | ------------------------------------------------------------------------------------------- | ----- | | **shortcuts** | Shortcut\[\] | The list of app shortcuts that should be set by default. Only available on Android and iOS. | 7.2.0 | ### Examples[¶](#examples "Permanent link") In `capacitor.config.json`: `[](#%5F%5Fcodelineno-3-1){ [](#%5F%5Fcodelineno-3-2) "plugins": { [](#%5F%5Fcodelineno-3-3) "AppShortcuts": { [](#%5F%5Fcodelineno-3-4) "shortcuts": [{ id: 'feedback', title: 'Feedback' }] [](#%5F%5Fcodelineno-3-5) } [](#%5F%5Fcodelineno-3-6) } [](#%5F%5Fcodelineno-3-7)} ` In `capacitor.config.ts`: `[](#%5F%5Fcodelineno-4-1)/// [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)import { CapacitorConfig } from '@capacitor/cli'; [](#%5F%5Fcodelineno-4-4) [](#%5F%5Fcodelineno-4-5)const config: CapacitorConfig = { [](#%5F%5Fcodelineno-4-6) plugins: { [](#%5F%5Fcodelineno-4-7) AppShortcuts: { [](#%5F%5Fcodelineno-4-8) shortcuts: [{ id: 'feedback', title: 'Feedback' }], [](#%5F%5Fcodelineno-4-9) }, [](#%5F%5Fcodelineno-4-10) }, [](#%5F%5Fcodelineno-4-11)}; [](#%5F%5Fcodelineno-4-12) [](#%5F%5Fcodelineno-4-13)export default config; ` ### iOS[¶](#ios "Permanent link") On iOS, you must add the following to your app's `AppDelegate.swift`: `[](#%5F%5Fcodelineno-5-1)+ import CapawesomeCapacitorAppShortcuts [](#%5F%5Fcodelineno-5-2) [](#%5F%5Fcodelineno-5-3)@UIApplicationMain [](#%5F%5Fcodelineno-5-4)class AppDelegate: UIResponder, UIApplicationDelegate { [](#%5F%5Fcodelineno-5-5) [](#%5F%5Fcodelineno-5-6) func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { [](#%5F%5Fcodelineno-5-7)+ if let shortcutItem = launchOptions?[.shortcutItem] as? UIApplicationShortcutItem { [](#%5F%5Fcodelineno-5-8)+ NotificationCenter.default.post(name: NSNotification.Name(AppShortcutsPlugin.notificationName), object: nil, userInfo: [AppShortcutsPlugin.userInfoShortcutItemKey: shortcutItem]) [](#%5F%5Fcodelineno-5-9)+ return true [](#%5F%5Fcodelineno-5-10)+ } [](#%5F%5Fcodelineno-5-11) return true [](#%5F%5Fcodelineno-5-12) } [](#%5F%5Fcodelineno-5-13) [](#%5F%5Fcodelineno-5-14)+ func application(_ application: UIApplication, performActionFor shortcutItem: UIApplicationShortcutItem, completionHandler: @escaping (Bool) -> Void) { [](#%5F%5Fcodelineno-5-15)+ NotificationCenter.default.post(name: NSNotification.Name(AppShortcutsPlugin.notificationName), object: nil, userInfo: [AppShortcutsPlugin.userInfoShortcutItemKey: shortcutItem]) [](#%5F%5Fcodelineno-5-16)+ completionHandler(true) [](#%5F%5Fcodelineno-5-17)+ } ` ## Demo[¶](#demo "Permanent link") A working example can be found [here](https://github.com/capawesome-team/capacitor-plugins/tree/main/packages/app-shortcuts/example). | Android | iOS | | ------- | --- | ## Usage[¶](#usage "Permanent link") `[](#%5F%5Fcodelineno-6-1)import { AppShortcuts } from '@capawesome/capacitor-app-shortcuts'; [](#%5F%5Fcodelineno-6-2) [](#%5F%5Fcodelineno-6-3)const clear = async () => { [](#%5F%5Fcodelineno-6-4) await AppShortcuts.clear(); [](#%5F%5Fcodelineno-6-5)}; [](#%5F%5Fcodelineno-6-6) [](#%5F%5Fcodelineno-6-7)const get = async () => { [](#%5F%5Fcodelineno-6-8) const result = await AppShortcuts.get(); [](#%5F%5Fcodelineno-6-9) return result.shortcuts; [](#%5F%5Fcodelineno-6-10)}; [](#%5F%5Fcodelineno-6-11) [](#%5F%5Fcodelineno-6-12)const set = async () => { [](#%5F%5Fcodelineno-6-13) await AppShortcuts.set({ [](#%5F%5Fcodelineno-6-14) shortcuts: [ [](#%5F%5Fcodelineno-6-15) { [](#%5F%5Fcodelineno-6-16) id: 'feedback', [](#%5F%5Fcodelineno-6-17) title: 'Feedback', [](#%5F%5Fcodelineno-6-18) description: 'Send us your feedback', [](#%5F%5Fcodelineno-6-19) }, [](#%5F%5Fcodelineno-6-20) { [](#%5F%5Fcodelineno-6-21) id: 'rate', [](#%5F%5Fcodelineno-6-22) title: 'Rate', [](#%5F%5Fcodelineno-6-23) description: 'Rate our app', [](#%5F%5Fcodelineno-6-24) } [](#%5F%5Fcodelineno-6-25) ], [](#%5F%5Fcodelineno-6-26) }); [](#%5F%5Fcodelineno-6-27)}; [](#%5F%5Fcodelineno-6-28) [](#%5F%5Fcodelineno-6-29)const addListener = async () => { [](#%5F%5Fcodelineno-6-30) AppShortcuts.addListener('click', (event) => { [](#%5F%5Fcodelineno-6-31) console.log('Shortcut clicked:', event.id); [](#%5F%5Fcodelineno-6-32) }); [](#%5F%5Fcodelineno-6-33)}; ` ## API[¶](#api "Permanent link") * [clear()](#clear) * [get()](#get) * [set(...)](#set) * [addListener('click', ...)](#addlistenerclick-) * [removeAllListeners()](#removealllisteners) * [Interfaces](#interfaces) ### clear()[¶](#clear "Permanent link") `[](#%5F%5Fcodelineno-7-1)clear() => Promise ` Remove all app shortcuts. Only available on Android and iOS. **Since:** 6.0.0 --- ### get()[¶](#get "Permanent link") `[](#%5F%5Fcodelineno-8-1)get() => Promise ` Get all app shortcuts. Only available on Android and iOS. **Returns:** `Promise<[GetResult](#getresult)>` **Since:** 6.0.0 --- ### set(...)[¶](#set "Permanent link") `[](#%5F%5Fcodelineno-9-1)set(options: SetOptions) => Promise ` Create or update app shortcuts. Only available on Android and iOS. | Param | Type | | ----------- | ------------------------- | | **options** | [SetOptions](#setoptions) | **Since:** 6.0.0 --- ### addListener('click', ...)[¶](#addlistenerclick "Permanent link") `[](#%5F%5Fcodelineno-10-1)addListener(eventName: 'click', listenerFunc: (event: ClickEvent) => void) => Promise ` Called when an app shortcut is clicked. Only available on Android and iOS. | Param | Type | | ---------------- | ------------------------------------------ | | **eventName** | 'click' | | **listenerFunc** | (event: [ClickEvent](#clickevent)) => void | **Returns:** `Promise<[PluginListenerHandle](#pluginlistenerhandle)>` **Since:** 6.0.0 --- ### removeAllListeners()[¶](#removealllisteners "Permanent link") `[](#%5F%5Fcodelineno-11-1)removeAllListeners() => Promise ` Remove all listeners for this plugin. **Since:** 6.0.0 --- ### Interfaces[¶](#interfaces "Permanent link") #### GetResult[¶](#getresult "Permanent link") | Prop | Type | Description | Since | | ------------- | ------------ | -------------------------- | ----- | | **shortcuts** | Shortcut\[\] | The list of app shortcuts. | 6.0.0 | #### Shortcut[¶](#shortcut "Permanent link") | Prop | Type | Description | Since | | --------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | **description** | string | The description. On **Android**, the launcher shows this instead of the short title when it has enough space. **Attention**: On **iOS**, the icon and the description must be used together. | 6.0.0 | | **id** | string | The unique identifier. | 6.0.0 | | **title** | string | The display name. | 6.0.0 | | **icon** | string \| number | The icon to display. On **Android**, the icon can be one of the following: - An integer value of the [R.drawable](https://developer.android.com/reference/android/R.drawable) enum (e.g. 17301547). - A string that represents the name of the drawable resource (e.g. "alert\_dark\_frame"). - A base64 encoded image string (e.g. "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/4QC..."). On **iOS**, the icon can be one of the following: - The constant integer value of the [UIApplicationShortcutIcon.IconType](https://developer.apple.com/documentation/uikit/uiapplicationshortcuticon/icontype) enum (e.g. 6). - A system symbol name (e.g. star.fill). - Name of the image asset from the asset catalogue. | 6.1.0 | | **androidIcon** | string \| number | The icon to display on Android. The icon can be one of the following: - An integer value of the [R.drawable](https://developer.android.com/reference/android/R.drawable) enum (e.g. 17301547). - A string that represents the name of the drawable resource (e.g. "alert\_dark\_frame"). - A base64 encoded image string (e.g. "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/4QC..."). | 7.2.0 | | **iosIcon** | string \| number | The icon to display on iOS. The icon can be one of the following: - The constant integer value of the [UIApplicationShortcutIcon.IconType](https://developer.apple.com/documentation/uikit/uiapplicationshortcuticon/icontype) enum (e.g. 6). - A system symbol name (e.g. star.fill). - Name of the image asset from the asset catalogue. | 7.2.0 | #### SetOptions[¶](#setoptions "Permanent link") | Prop | Type | Description | Since | | ------------- | ------------ | -------------------------- | ----- | | **shortcuts** | Shortcut\[\] | The list of app shortcuts. | 6.0.0 | #### PluginListenerHandle[¶](#pluginlistenerhandle "Permanent link") | Prop | Type | | ---------- | ------------------- | | **remove** | () => Promise | #### ClickEvent[¶](#clickevent "Permanent link") | Prop | Type | Description | Since | | -------------- | ------ | ----------------------------------------------------------- | ----- | | **shortcutId** | string | The unique identifier of the app shortcut that was clicked. | 6.0.0 | ## Changelog[¶](#changelog "Permanent link") See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-shortcuts/CHANGELOG.md). ## License[¶](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-shortcuts/LICENSE). May 17, 2026 Back to top