Section numbers are those of the W3C Working Draft of 18 November 2026 of the Web Application Manifest, read as text for this site; the image members are from the Image Resource draft. The specification gives an algorithm for each member; what follows is its content in our words.
Members of the manifest
| Member | Value | What the draft says | § |
|---|---|---|---|
name | string | The name of the application as usually shown; also its accessible name when installed. Localizable. | 1.4 |
short_name | string | A short version for where space is short. Localizable. | 1.5 |
icons | array of image resources | Images that represent the application. Localizable. | 1.7, 2 |
start_url | string, a URL | The URL the user agent should load on launch. Purely advisory: a user agent may ignore it. Resolved against the manifest URL; if it is not same origin as the document it is ignored. Default: the document URL. | 1.10 |
scope | string, a URL | The navigation scope. Resolved against the manifest URL, query and fragment dropped; if the start URL is not within it, it is ignored. Default: the start URL with its file name, query and fragment removed. Always declaring it is recommended. | 1.6 |
id | string, a URL | The identity of the application: a URL of the same origin as the start URL, with its fragment removed; resolved against the start URL’s origin, so "/" and "../" forms work; if absent, the start URL is the identity. | 1.11 |
display | string | The preferred display mode: fullscreen, standalone, minimal-ui or browser (default). Trimmed and lower-cased; any other value leaves the default. The draft gives a fallback chain: fullscreen falls back to standalone, then minimal-ui, then browser. | 1.8, 6 |
orientation | string | The default screen orientation: any, natural, landscape, portrait, portrait-primary, portrait-secondary, landscape-primary or landscape-secondary. Another value is ignored. | 1.9 |
theme_color | string, a CSS colour | The default theme colour; a themeable member. A user agent may override it with a theme-color meta element in scope and may ignore its alpha. | 1.12 |
background_color | string, a CSS colour | The expected background while the application loads; it must not be used once the stylesheet is available. A themeable member. | 1.13 |
shortcuts | array of shortcut items | Links to key tasks, best in priority order; a user agent may truncate the list. | 1.14, 3 |
dir | string | The default text direction of the localizable members: ltr, rtl or auto (default); trimmed and lower-cased. | 1.2 |
lang | string, a language tag | The language of the localizable members (BCP 47 well-formed, case-insensitive); an invalid tag leaves the language unknown. | 1.3 |
color_scheme_dark | object | Overrides for theme_color and background_color when the operating system uses a dark colour theme. | 1.16 |
name_localized, short_name_localized, icons_localized | object (language map) | Localized values keyed by language tag; a localized text is a string or an object with value, optional dir and lang. | 1.15 |
Image resources (icons)
| Member | Value | Rule |
|---|---|---|
src | URL | Required (required USVString src): where the image is fetched from. A src that is not a string makes the image resource fail; an empty string is a string and parses against the base URL (Image Resource, “processing an image resource from JSON”). |
sizes | string | Optional; the syntax of the sizes attribute of a link element, such as "16x16 32x32 64x64" or any. A sizes value that cannot be parsed makes the image resource fail. |
type | string | Optional image MIME type; an unparsable one makes the image resource fail. |
label | string | The accessible name of the image. |
purpose | space-separated tokens | Manifest image resources only. monochrome, maskable, any; default any; tokens that are not recognised are dropped, and if none is left the icon is ignored. “Unless declared otherwise by the developer, a user agent can use an icon for any purpose.” |
Shortcut items
| Member | Rule |
|---|---|
name | The name of the shortcut as shown in a context menu (3.1). Localizable. |
short_name | A short version of the name (3.2). |
description | Describes the purpose; a user agent may expose it to assistive technology (3.3). |
url | A URL within the manifest’s scope that opens when the shortcut is used (3.4). |
icons | Images for the shortcut (3.5). |
Section 3.7 (“processing shortcut items”) skips a shortcut item that is not an object, has no name or an empty one, has no url or a url that is not a string, whose url does not parse against the manifest URL, or whose parsed url is not within the scope. (The explorer’s Shortcuts tab shows “used” or “skipped: why” for each item; it judges the scope only for absolute URLs and URLs starting with /, see the Not described list of the overview.)