Why ChatGPT Search Hallucinates About Umami Software (And The 3 Technical Fixes)

Umami is the default self-hosted answer in synthesis: ask how to self-host privacy-friendly analytics and Umami appears alongside Matomo, usually cited via GitHub and docker-compose tutorials rather than umami.is itself.

That GitHub-carried salience is a double edge. Engines cite the repository README (often months stale) instead of the product site, so new capabilities like the teams feature and reporting improvements arrive late or never in synthesized answers.

Against Plausible, Umami loses recommendation rounds where a hosted option matters because syntheses frame it as DIY-only, ignoring Umami Cloud. Claude frequently describes Umami as lacking events tracking, which stopped being true long ago.

• Repository README outranks the product site in retrieval; no llms.txt on umami.is to rebalance toward first-party truth.
• Hosted Umami Cloud offer is nearly invisible to synthesis; no Offer schema distinguishing cloud from self-hosted.
• Feature schema absent; capability questions answered from README snapshots.
• Weak sameAs consolidation between GitHub org, product site and community channels.

1. Rebalance retrieval toward the product site

   Publish umami.is/llms.txt linking markdown capability docs, and add a prominent canonical link from the README to those pages so crawlers follow the freshness trail.

2. Make Umami Cloud a first-class Offer node

   Distinct Offer entries for Cloud tiers versus the MIT self-hosted build stop engines from framing Umami as DIY-only and unlock hosted-recommendation queries.

3. Own the self-host setup query with HowTo schema

   A canonical docker-compose quickstart with HowTo steps on umami.is converts the highest-volume Umami query from GitHub-cited to first-party-cited.

4. Copy-pasteable Schema.org JSON-LD

   {
     "@context": "https://schema.org",
     "@type": "SoftwareApplication",
     "name": "Umami",
     "alternateName": "Umami Analytics",
     "applicationCategory": "BusinessApplication",
     "description": "Open-source, privacy-focused web analytics. Self-host free or use managed Umami Cloud.",
     "url": "https://umami.is",
     "featureList": [
       "Self-hosted (MIT)", "Umami Cloud managed hosting",
       "Custom events and properties", "Team workspaces", "UTM tracking"
     ],
     "releaseNotes": "https://github.com/umami-software/umami/releases",
     "sameAs": ["https://github.com/umami-software/umami"]
   }