Configure options below — the preview updates in real time.

Identity & Naming

Core fields that identify your Progressive Web App.

The full name of the web application as it is usually displayed to the user.

A shorter version of the app name for use where there is insufficient space (e.g. mobile home screen). Recommended under 12 characters.

A general description of what the web application does. Used by app stores and search engines.

A unique identifier for the web application, preventing duplicate installations and tying the app identity across updates.

Presentation & Appearance

Controls how the PWA is displayed to users.

The URL that loads when a user launches the application.

Defines the default theme color for the application. Affects OS/browser UI elements like the status bar or title bar.

Defines a placeholder background color displayed before the stylesheet is loaded. Used to generate the splash screen.

Determines the developer's preferred display mode (how much of the browser UI is shown).

A fallback chain of preferred display modes considered before the display member. The first supported mode is applied.

Defines the default orientation for the web application's top-level browsing contexts.

Specifies the primary text direction for the name, short_name, and description members.

Specifies the primary language for the values in the manifest. Use a BCP 47 language tag.

Icons & Graphics

Specifies image files used as application icons and screenshots.

Application icons array. Each entry maps an icon src path to its sizes. Icons support src, sizes, type (e.g. image/png), and purpose (any, maskable, monochrome).

Screenshots showcasing the application, used by app stores and the rich install prompt. Each entry maps a screenshot src path to its sizes. Screenshots support src, sizes, type, form_factor (wide, narrow), label, and platform.

App Discovery & Store

Fields that help categorize and promote your PWA in app stores.

An array of categories hinting at the application's domain, used by app listings.

The International Age Rating Coalition (IARC) certification code for the app.

Prefer Related ApplicationsRecommends the browser suggest the native apps listed in related_applications rather than installing the PWA.

Native applications associated with the web app. Each entry maps a platform (play, itunes, windows) to an app store URL. Use to promote native app alternatives.

Routing & Integration

Controls navigation scope, shortcuts, and platform integrations.

Defines the navigation scope. Navigating outside this scope opens a standard browser tab.

Extends the app scope to include other origins for multi-domain presentation. Each entry maps an origin pattern to a label.

Declares if links within the PWA's scope clicked in other apps should default to opening the PWA instead of the browser. Chromium/Edge specific.

Shortcuts

Defines links to key tasks or pages, accessible from the app launcher or OS jump lists.

Shortcut definitions. Each entry maps a shortcut name to its URL path. Shortcuts also support short_name, description, and icons.

Launch Handler

Controls how the app launches, particularly whether it opens in a new or existing window. Experimental.

Specifies the context in which the app should be loaded when launched. The browser uses this to determine whether to reuse an existing window or open a new one.

File Handlers

Allows the PWA to declare itself as a handler for certain file types when opened from the OS file explorer. Experimental.

File handler definitions. Each entry maps a MIME type to accepted file extensions (e.g. image/png: .png, .apng). The action URL route is set via the key.

Protocol Handlers

Registers the web app to handle specific custom URI schemes (e.g. web+music:// or mailto:). Experimental.

Protocol handler definitions. Each entry maps a protocol scheme (must be web+ prefixed or a safe standard protocol) to a URL template with %s as placeholder.

Share Target

Allows the PWA to act as a target for sharing content from other apps via the OS share sheet. Experimental.

The URL route that receives shared content.

The HTTP request method used for the share action.

The encoding type for share data when method is POST.

Query parameter name for the shared document title.

Query parameter name for the shared message body.

Query parameter name for the shared URL.

Note Taking

Integrates with OS note-taking triggers such as stylus hardware buttons. Experimental.

The URL to open when a new note is requested by the operating system.

Platform-Specific

Vendor-specific and experimental fields for enhanced platform integration.

The ideal pixel width for the Microsoft Edge side panel when the PWA is pinned as a sidebar app.