Feature referenceSites and chat behavior · 02 of 05

Sites and chat behavior

Widget installation

Widget installation places a Site-specific deferred script on the published website. The snippet loads Stand, identifies the Site through `data-stand-id`, and lets the backend confirm that the expected domain has requested availability.

Availability
All plans
Configured in
Dashboard → Sites → select a Site → Installation snippet
Category
Sites and chat behavior
Reference status
Current
01

Install the Site snippet

Representative installation shape
<script defer src="https://cdn.stand.chat/widget/stand.js" data-stand-id="YOUR-SITE-ID"></script>

Copy the generated snippet for the actual Site. Do not reuse this placeholder or another Site’s ID.

  • Open the Site, expand Installation snippet, and copy the generated script without changing its Site identifier.
  • Add the generated deferred script once through the website’s shared page template, code, tag manager, or builder custom-code area. The document head is suitable; placing it before the closing </body> tag also works.
  • Publish the change to the real visitor-facing domain; a saved draft or local preview does not verify production installation.
  • Visit the published page so the widget performs its Site lookup, then return to Sites and confirm Installed status.
02

Pending and installed status

StatusMeaning
PendingStand has not yet observed a successful matching request from the generated Site snippet.
InstalledA page on the normalized Site domain loaded the snippet and reached the Stand availability path for that Site.
Installed but no chatThe script is present, but Site enablement, routing eligibility, I chat here, Stand-in coverage, behavior rules, or organization capacity prevents a visitor conversation.
03

Domain and Site-ID matching

  • The data-stand-id selects one Site record and its configuration.
  • The page domain must normalize to the Site’s saved domain. Preview and staging hostnames need their own matching configuration when they should run Stand.
  • Protocol, path, and a leading www. are removed for the Site-domain comparison.
  • Path-specific behavior and Stand-in specialization are evaluated only after the Site and domain match succeeds.
04

If the widget does not become available

  • Confirm the copied snippet was published in the active template or tag-manager container, not only saved as a draft.
  • Inspect whether cache or CDN output still serves the previous page.
  • Confirm the page hostname matches the Site rather than a preview or alternate domain.
  • Check that the Site is enabled and Chat widget status lists an eligible rep or Stand-in.
  • Review Chat widget behavior for a delayed, scroll-based, manual, or suppressed reveal before assuming installation failed.
05

Security and lifecycle boundaries

  • The public Site identifier selects configuration but is not a customer secret or rep authentication credential.
  • The stable snippet does not need to change when owners edit runtime Site behavior.
  • Removing the snippet stops future page loads from initializing Stand but does not delete the Site record or prior conversations.
  • Installing the snippet does not give Stand permission to bypass the website’s own authentication or read private backend data.
06

Example

The screen below shows the feature in its normal Stand context. Labels and surrounding controls may vary with account state and plan.

Widget installation in the Stand dashboard
Widget installation in Stand. The image is illustrative; the reference text defines the supported behavior.