short_name

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The short_name manifest member is used to specify a short name for your web application, which may be used when the full name is too long for the available space.

Syntax

json
/* Short names of web apps */
"short_name": "TaskPlanner"
"short_name": "RecipePantry"

Values

short_name

A string that specifies a short version of your web app's name.

Description

Browsers may use short_name in place of name when there is insufficient space to display the full name, such as on a device's home screen, in the application switcher, or in other space-constrained contexts.

Keep the following points in mind when selecting a short name for your web app:

  • It should be a concise version of your app's name.
  • While aiming for brevity, it should still be recognizable and meaningful.
  • Consider how it will appear in space-constrained contexts.
  • Follow the same guidelines for cultural sensitivity and trademark as for name.

Examples

Adding a short name for your web app

Consider a web app that helps users plan and log their hiking adventures. The name has been defined as Trail Navigator. A short_name can be added to the manifest as follows:

json
{
  "name": "Trail Navigator",
  "short_name": "TrailNav"
}

The app's shorter name TrailNav is concise and is suitable for limited space contexts. It maintains a connection to the app's full name and is easy to remember.

Specifications

Specification
Web Application Manifest
# short_name-member

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
short_name
Chrome – Full support
Chrome 39 (Release date: 2014-11-18)
footnote
footnote short_name or name is required for a web app to be installable.
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote
footnote short_name or name is required for a web app to be installable.
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 26 (Release date: 2014-12-03)
footnote
footnote short_name or name is required for a web app to be installable.
Safari – Full support
Safari 17 (Release date: 2023-09-18)
footnote Full support
Chrome Android – Full support
Chrome Android 39 (Release date: 2014-11-12)
footnote
footnote short_name or name is required for a web app to be installable.
Firefox for Android – Full support
Firefox for Android 79 (Release date: 2020-07-28)
footnote Full support
Opera Android – Full support
Opera Android 26 (Release date: 2014-12-02)
footnote
footnote short_name or name is required for a web app to be installable.
Safari on iOS – Full support
Safari on iOS 11.3 (Release date: 2018-03-29)
footnote Full support
Samsung Internet – Full support
Samsung Internet 4 (Release date: 2016-03-11)
footnote
footnote short_name or name is required for a web app to be installable.
WebView Android – Full support
WebView Android 39 (Release date: 2014-11-12)
footnote
footnote short_name or name is required for a web app to be installable.
WebView on iOS – Full support
WebView on iOS 11.3 (Release date: 2018-03-29)
footnote Full support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

See also