App shortcuts
Adds quick actions to the app icon's long press or right click menu.
In one line
Can add quick actions to an installed app icon's long press or right click menu
Adds quick actions to the app icon's long press or right click menu.
Offers up to a few deep links from the OS launcher.
What it can and can't do
What the user does: You install the app, then press and hold or right click its icon
It can
- Show a few links like Compose or New tab on the icon menu
- Jump straight into part of the app
- Use up to a handful of shortcuts
It cannot
- Add many shortcuts, since the system limits them
- Work for a site that is not installed
- Work in Firefox, or on iPhone Chrome
- Open anything without you tapping the shortcut
How it differs between platforms: Chrome, Edge, Samsung Internet and Safari on Mac support it. iPhone and Firefox do not.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 96 | 2021-11-15 | None |
| Edge | Supported | 96 | 2021-11-19 | None |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Supported | 17.4 | 2024-03-05 | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Supported | 84 | 2020-07-27 | None |
| Samsung Internet | Supported | 14.0 | 2021-04-17 | None |
How a site asks for it
| API | manifest shortcuts[] |
| Browser compat keys | manifests.webapp.shortcuts |
| How access is granted | install |
| What the user sees | None |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | No |
| How long it lasts | Per origin |
| How to take it back | Site settings |
| Inside an iframe | Same as top level; cross-origin iframes need a permissions policy where listed |
Typical flow
- Call the API
- Browser applies its access rules
- Page receives the result
Data you get
What comes back: Adds quick actions to the app icon's long press or right click menu.
Shape: object
How often: on demand
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
shortcuts | list | None | name, url, icons | Chrome allows 4 shown on Android |
Technical limits
- Installed PWA only
The story
What it is
An installed web app can add quick actions to its icon, like New message or Search.
For you
You press and hold the app icon, or right click it, and see quick actions like New post or Scan. One tap jumps you straight to that part of the app.
For makers
Makers shorten the path to their main features, which raises use. It makes a web app feel as polished as a native one. It only works once the app is installed.
Where you see it
| Type | Example | Apps |
|---|---|---|
| social | Long press a social app icon and choose New post to open the compose screen. | X |
| messaging | A web mail icon offers Compose, so you start a draft in one tap. | Gmail |
| music | A web music icon offers Liked songs and Search. | None named |
| games | A web game launcher icon offers Continue game and Friends. | None named |
| shopping | A store icon offers Track order and Cart. | Starbucks |
| productivity | A task app offers Add task, which opens a blank task. | Todoist |
| travel | A travel icon offers My trips and Boarding pass. | None named |
Risks
- Only installed apps
- Little risk
What the platform says
- MDN Web Docs: App shortcuts. Lets an installed web app add quick actions to its icon's menu, as native apps do.
Good uses and abuse
Legitimate uses
- Compose, new tab
Known abuse
- None
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 1 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2020, Chrome 84: Android
- 2021, Chrome 96: Desktop
- 2024, Safari 17.4: Safari
Sources
How well checked: Checked against real behavior.