Skip to main content
All docs

Website widget is not showing

Use this when the web person says the Porchlight snippet is installed but the bubble does not appear on the live customer site.

First checks

  1. Open the exact live page where buyers should see Porchlight. Do not test only in the CMS preview.
  2. Refresh in a private browser window so old cache and logged-in admin bars do not affect the test.
  3. Confirm the snippet appears once on the page, usually before the closing </body> tag.
  4. Confirm data-org matches the Porchlight organization slug exactly.
  5. Confirm the page host is allowed in Settings -> Branding. Check both example.com and www.example.com if the site uses both.
  6. Confirm the agent is published and the launch path expects the existing website widget.

What the browser is telling you

Open the browser console on the customer site:

  • No request for widget.js: the CMS did not publish the snippet, a cache is serving an old page, or the snippet is on a different template.
  • Request for widget.js is blocked: the site security policy, plugin, proxy, or firewall is blocking Porchlight.
  • Session request returns blocked host: the live page host is missing from Settings -> Branding.
  • Bubble loads but cannot open: use the blank iframe and CSP guide.

Common fixes

  • Publish the website after adding the snippet, then clear CMS, CDN, and page-builder cache.
  • Add the snippet site-wide instead of only on one landing page if the buyer can enter from multiple pages.
  • Save the exact customer website host in Settings -> Branding.
  • Ask the web person to keep the async, src, data-org, and data-source attributes unchanged.
  • Remove duplicate Porchlight snippets if the site has more than one.

Send Porchlight this context

If it is still blocked, open support and include:

  • The live website URL.
  • The CMS or website builder.
  • The Porchlight org slug.
  • A screenshot of the browser console.
  • Whether the snippet is on production, staging, or only inside a preview.