A JSON file that tells browsers and AI crawlers how a brand should look when installed as an app or surfaced in AI-generated answers.
Website owners or developers concerned with PWA installation and brand presentation in AI search results.
01What it is and how it works
The manifest lives at /manifest.json (or another path you declare) and is linked from the HTML ` with . Key fields include name (full brand name), short_name (label under the icon), icons (array of image objects with src, sizes, type, purpose), theme_color (browser chrome color), background_color (splash screen color), display (standalone, minimal-ui, or browser), start_url (entry point), and scope` (navigation boundary). AI crawlers that render pages — such as those powering AI Overviews or chat citations — fetch the manifest to extract the authoritative brand assets instead of guessing from HTML meta tags.
It is a small text file that gives your site a consistent name, logo, and color scheme wherever AI or a browser shows it.
02What to do about it
Create a valid manifest.json at the root or a known path. Include at least one 512×512 PNG icon with purpose: "any maskable" so it works as a maskable icon on Android and as a fallback elsewhere. Set theme_color to your primary brand hex value and background_color to a matching solid color for the splash screen. Choose display: "standalone" for an app-like feel. Link the manifest in every canonical page’s ``. Test with Lighthouse’s PWA audit and the Chrome DevTools Application panel to confirm the manifest is parsed and icons load. Re‑validate after any redesign or logo change.
03How it is measured or noticed
Open Chrome DevTools → Application → Manifest to see the parsed fields and icon previews. Run Lighthouse (Performance → Progressive Web App) and check the "Manifest" and "Icons" audits. In Search Console, the Enhancements → Rich results report may surface manifest‑related structured data if you also use WebApplication schema. For AI search, monitor how your brand appears in AI Overviews, Perplexity citations, or ChatGPT browsing results — consistent name, logo, and color indicate the manifest is being read. Absence of a logo or a generic favicon in those surfaces often means the manifest is missing, malformed, or blocked.
04Common mistakes
- Serving the manifest with
Content-Type: text/plaininstead ofapplication/manifest+jsonorapplication/json. - Providing only a 192×192 icon; large screens then downscale a blurry image.
- Omitting
purpose: "maskable"so the icon gets a white background on Android. - Setting
start_urlto/with a trailing slash mismatch that creates a scope error. - Blocking
/manifest.jsoninrobots.txtor vianoindexheaders. - Duplicating the manifest link with different
hrefvalues on the same page.
05Limits
The manifest does not directly influence ranking. It only affects presentation when the page is installed or when an AI system chooses to display brand assets. It is not a substitute for WebApplication or Organization schema.org markup — those provide structured data for knowledge panels and rich results, while the manifest controls PWA installation UI. If your site is not installable (no service worker, no HTTPS), the manifest is ignored by browsers. AI crawlers that do not render JavaScript will not fetch a manifest injected client‑side; the file must be present in the initial HTML response.
06Worked example
A minimal, production‑ready manifest for a brand called "Acme Analytics":
{
"name": "Acme Analytics",
"short_name": "Acme",
"start_url": "/",
"display": "standalone",
"background_color": "#003366",
"theme_color": "#003366",
"icons": [
{
"src": "/icons/icon-192.png",
"sizes": "192x192",
"type": "image/png",
"purpose": "any"
},
{
"src": "/icons/icon-512.png",
"sizes": "512x512",
"type": "image/png",
"purpose": "any maskable"
}
]
}
Frequently asked questions
How does a web manifest differ from meta tags like apple-touch-icon or theme-color?
A web manifest consolidates all install and branding signals into one JSON file, while meta tags scatter them across the HTML <head>. The manifest is the single source of truth for PWAs and AI crawlers; meta tags remain fallbacks for older browsers and some social platforms.
Do I need a web manifest if my site isn't a progressive web app?
Yes, if you want control over how your brand appears when AI search surfaces your content or when users add the page to their home screen. Without it, browsers and AI systems fall back to generic icons, truncated titles, and default theme colors.
Who should create and maintain the manifest — developers, designers, or SEO?
Developers typically author the file because it must be valid JSON and served with the correct MIME type. Designers supply the icon assets and color values. SEO or product owners define the name, short_name, and description fields that AI answers may quote.
Does the manifest still matter now that AI crawlers can read HTML directly?
Yes. AI crawlers use the manifest as a structured, machine‑readable summary of brand identity. It reduces ambiguity compared to parsing scattered meta tags and ensures consistent representation across chat interfaces, voice assistants, and search snippets.
What happens if my manifest has invalid JSON or missing required fields?
Browsers and AI crawlers will ignore the file entirely and fall back to heuristic extraction from HTML. You’ll see no install prompt, generic icons, and the page title may be truncated in AI answers. The error is silent — no console warning unless you check DevTools.
How long after deploying a manifest will AI search features pick it up?
There is no fixed SLA. Most AI crawlers re‑fetch on their normal recrawl cycle, which can range from hours to weeks. You can accelerate discovery by submitting the manifest URL via IndexNow or the search console’s URL inspection tool, but the manifest itself does not trigger a priority crawl.
Asked out loud
spoken, not typedThe same term in the words somebody uses speaking to an assistant rather than typing into a box — written from the situation, which is why each one carries the situation it came from.
A web manifest — a JSON file linked in the HTML head — defines the install name, icons, theme color, and display mode. Fix the manifest.json and the next install will use the corrected assets.
Edit the theme_color field in your web manifest. AI search features read that value directly, so the change appears as soon as the manifest is re‑crawled.
Look for a <link rel="manifest" href="/manifest.json"> tag in the page source. That manifest file holds every branding asset the install prompt and AI answers use.