---
title: "Let people install the site · Agent Wranglers"
url: https://agentwranglers.se/playbook/website/offline-and-installed-apps/pwa-manifest
id: WEB-225
level: Recommended
updated: 2026-10-22
build: a2a6bdfed830
tokens: 762
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Let people install the site

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Offline and installed apps](https://agentwranglers.se/playbook/website/offline-and-installed-apps.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-22.

- ID: WEB-225
- Level: Recommended
- Chapter: [Offline and installed apps](https://agentwranglers.se/playbook/website/offline-and-installed-apps.md)
- Rule: Publish a web app manifest with a name, start address, colours, and 192 and 512 px icons, including a maskable one.
- Check: `curl -sI` on the manifest answers 200 as `application/manifest+json`, and each icon in it answers 200. DevTools › Application › Manifest shows no errors.
- How: Serve `manifest.webmanifest` as `application/manifest+json` and link it from the head. Include `name`, `short_name`, `start_url`, `display`, colours, and any and maskable icons.

## Examples

**Using these examples:** they show one way to follow this rule. Keep the behaviour and the check, not the syntax. Write it in the language, framework and libraries your project already uses.

### JSON example

```json
{
  "name": "Example Studio",
  "short_name": "Example",
  "start_url": "/",
  "display": "standalone",
  "theme_color": "#2347d6",
  "background_color": "#ffffff",
  "icons": [
    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" },
    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" },
    { "src": "/icon-maskable.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
  ]
}
```

### HTML example

```html
<link rel="manifest" href="/manifest.webmanifest">
```

## Sources

- [W3C Web Application Manifest](https://www.w3.org/TR/appmanifest/)

## Related rules

- WEB-8 [Ship a full set of icons](https://agentwranglers.se/playbook/website/html-basics/favicons.md) in Website
- WEB-264 [Give the installed app a fixed identity](https://agentwranglers.se/playbook/website/offline-and-installed-apps/manifest-id-and-scope.md) in Website
- AXS-9 [Work in both orientations](https://agentwranglers.se/playbook/accessibility/seeing-and-reading/orientation.md) in Accessibility

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/website/offline-and-installed-apps/pwa-manifest">Agent Wranglers website playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Keep working when the network drops](https://agentwranglers.se/playbook/website/offline-and-installed-apps/offline-support.md)
- Next: [Give the installed app a fixed identity](https://agentwranglers.se/playbook/website/offline-and-installed-apps/manifest-id-and-scope.md)
- [Offline and installed apps](https://agentwranglers.se/playbook/website/offline-and-installed-apps.md)