Skip to content
porchlight

Add live chat to an HTML website

Use the install snippet from your Porchlight workspace. One installation in your shared page template is enough; adding a second copy can make troubleshooting harder.

Before you change the website

Create or select the website in your Porchlight workspace and open its installation instructions. Check the website address and copy its own snippet. The site identifier connects visitors to the correct website and workspace; the example below is deliberately a placeholder.

Keep a copy of the template before editing it. For a site maintained by another person, send them the snippet and the pages where you want it to appear. A public site identifier is intended for the browser. A secret API key or identity-signing secret does not belong in the snippet.

Add the snippet to the shared layout

Place the script just before the closing body tag in the layout used by your public pages. If the site has separate templates, add it once to each template that needs chat. Replace YOUR_SITE_ID with the identifier supplied by your workspace.

<script async src="https://porchlight.1001toolbox.com/l.js" data-site="YOUR_SITE_ID"></script>

The async attribute allows the browser to continue reading the page while the loader downloads. The widget manages its own interface and isolates its styling from your site's CSS. Keep the existing website content and scripts in place.

Check the real visitor experience

  1. Open the published page in a private browser window and on a phone-sized screen.
  2. Check that the correct website is selected and its domain is allowed in Porchlight.
  3. Confirm the launcher does not cover navigation, consent controls or the main action.
  4. Check what visitors see when a person is available, when AI can help and when the team is away.
  5. When you are ready to send a deliberate test message, verify that it reaches the intended Front Desk and assign someone to follow up.

Installing the script does not make a team available to answer. Review your availability and any AI content before inviting visitors to rely on them.

If the widget does not appear

Check that the placeholder was replaced, the script exists in the rendered page and the browser can request /l.js from the Porchlight host. An ad blocker, a consent manager or a Content Security Policy can block that request. Inspect the browser's reported error rather than disabling your site's security policy.

After an installation change, clear the relevant site cache and reload in a private window. Avoid installing through both your template and a tag manager at the same time. If you need help, describe the page URL and the browser error without sending account passwords.

Back to the top

Give your visitors a warmer welcome.

Bring your team and your knowledge into one shared workspace.

Open a free workspace