Skip to Content
Platform.Ontology

App shortcuts

Adds quick actions to the app icon's long press or right click menu.

Works without askingHome screen and system linksLauncherWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported962021-11-15None
EdgeSupported962021-11-19None
FirefoxNot supportedNot availableNot listedNone
SafariSupported17.42024-03-05None
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported842020-07-27None
Samsung InternetSupported14.02021-04-17None

How a site asks for it

APImanifest shortcuts[]
Browser compat keysmanifests.webapp.shortcuts
How access is grantedinstall
What the user seesNone
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. 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

FieldTypeUnitRangePrecision
shortcutslistNonename, url, iconsChrome 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

TypeExampleApps
socialLong press a social app icon and choose New post to open the compose screen.X
messagingA web mail icon offers Compose, so you start a draft in one tap.Gmail
musicA web music icon offers Liked songs and Search.None named
gamesA web game launcher icon offers Continue game and Friends.None named
shoppingA store icon offers Track order and Cart.Starbucks
productivityA task app offers Add task, which opens a blank task.Todoist
travelA travel icon offers My trips and Boarding pass.None named

Risks

  • Only installed apps
  • Little risk

What the platform says

Good uses and abuse

Legitimate uses

  • Compose, new tab

Known abuse

  • None

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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.

On this page