Manifest member in Manifest
description manifest member
Published Updated
The description manifest member is a single string that says what the web app does. The W3C Application
Information registry defines it as store-listing metadata; Chromium additionally shows it to
the user in the richer install dialog, next to the screenshots, and exposes it as the
accessible description of the installed app.
Chrome 88, Edge 88, Samsung Internet 15.0, and Android WebView 88 read the member (BCD
manifests.webapp.description). The compat data records no support in Firefox and Safari; on Firefox for
Android the property parses but has no effect.
Member
Section titled “Member”| Property | Value |
|---|---|
| Type | string. Plain text; HTML is not interpreted and line breaks are collapsed in the install dialog. |
| Default | absent. With no description Chrome’s install dialog shows only the name, origin, and icon, and a store listing falls back to whatever text the packager asks for. |
| Example value | "Track your habits and build streaks, even offline.". |
A value that is not a string is dropped with the parser’s generic message, property 'description' ignored, type string expected.. There is no length limit in the format, but
Chrome’s install surfaces truncate, and DevTools warns once the string passes 300
characters. Write the first sentence to stand alone.
The member is the default-language text. description_localized (see the localization entry)
carries per-language variants keyed by BCP 47 tag; Chromium falls back to description when no
variant matches the UI language.
Examples
Section titled “Examples”Both examples ship the same text; they differ in where it is read.
Writing a description that survives truncation
Section titled “Writing a description that survives truncation”Put the app’s distinguishing feature in the first clause and keep the whole string well under 300 characters. The second sentence is safe to lose.
{ "name": "Habit Ledger", "short_name": "Habits", "description": "Track daily habits and build streaks, fully offline. Export to CSV, sync when you are back online, no account needed.", "screenshots": [ { "src": "/shots/narrow-1.png", "sizes": "1080x1920", "type": "image/png", "form_factor": "narrow" } ]}Chrome 94 on Android and Chrome 108 on desktop render this text in the richer install dialog
only when at least one screenshot is present; without screenshots the plain dialog omits the
description.
Checking the shipped description from a deployment test
Section titled “Checking the shipped description from a deployment test”No API reports whether the browser or a store used the text. What a test can do is assert that the deployed manifest carries a non-empty string within the truncation budget. The fallback branch handles contexts with no document (a Node test runner).
export async function describedManifest(manifestUrl = '/manifest.webmanifest') { const manifest = await fetch(manifestUrl).then((r) => r.json()); const text = manifest.description; if (typeof text !== 'string' || text.trim() === '') { return { ok: false, reason: 'description missing' }; } if (text.length > 300) { return { ok: false, reason: `description is ${text.length} chars; Chrome truncates past 300` }; } return { ok: true, text };}Run it against the production URL after each deploy; a CDN that strips or rewrites the manifest shows up here before it shows up in the install dialog.
See also
Section titled “See also”- categories manifest member
- screenshots manifest member
- lang, dir, and *_localized manifest members
- Richer install UI: enriching the install prompt with description and screenshots
- Web App Manifest - Application Information: description member (w3c.github.io)
- Provide a custom install experience (web.dev)
Specifications
| Specification | Status |
|---|---|
| Web App Manifest: description | W3C draft |
- Legend
- Yes
- Partial
- Flag
- No
- Unknown
| Browser / Platform | Support | Versions | Confidence | Source | Notes |
|---|---|---|---|---|---|
| Chrome (Desktop)# | Yes | 88 | high | source | — |
| Chrome (Android)# | Yes | 88 | high | source | 1 |
| Edge (Desktop)# | Yes | 88 | high | source | 2 |
| Firefox (Desktop)# | No | — | high | source | 3 |
| Firefox (Android)# | No | — | high | source | 4 |
| Safari (macOS)# | No | — | high | source | 5 |
| Safari (iOS)# | No | — | high | source | 67 |
| Samsung Internet# | Yes | 15.0 | high | source | 8 |
| WebView (Android)# | Yes | 88 | high | source | 9 |
- Derived by browser-compat-data mirroring from Chrome.
- Derived by browser-compat-data mirroring from Chrome.
- No Firefox support is recorded in browser-compat-data.
- The property parses, but has no effect.
- No Safari support is recorded in browser-compat-data.
- No Safari on iOS support is recorded in browser-compat-data.
- Derived by browser-compat-data mirroring from Safari.
- Derived by browser-compat-data mirroring from Chrome Android.
- Derived by browser-compat-data mirroring from Chrome Android.