Install the widget

The widget is one script tag. There is nothing to compile, no package to install and no server-side component.

The snippet

Find your license key in the dashboard under your account settings, then add this before the closing </body> tag on every page where you want the widget:

<!-- EasyChatDesk widget -->
<script>
  window.__ecd = { license: "YOUR-LICENSE-KEY" };
</script>
<script async src="https://cdn.easychatdesk.com/widget.min.js"></script>

That is the whole installation. The async attribute matters: it means the browser keeps rendering your page while the widget loads, so the widget never delays your Largest Contentful Paint.

Load the page, and the launcher should appear within a second or two. If it does not, see troubleshooting.

Platform-specific paths

The snippet is identical everywhere; only the place you paste it changes.

Platform	Where to paste it
WordPress	Theme footer (footer.php), a code snippets plugin, or a Custom HTML block in a footer widget area
Shopify	theme.liquid, just before </body>
Wix	Settings → Custom Code → Add Code, applied to all pages, in the Body section
Webflow	Project Settings → Custom Code → Footer Code
Squarespace	Settings → Advanced → Code Injection → Footer
BigCommerce	Storefront → Script Manager → footer placement
Plain HTML	Before </body> in each page, or in your shared footer include

Longer walkthroughs with screenshots: WordPress, Shopify, WooCommerce, Wix, Webflow, Squarespace.

Restricting it to specific pages

By default the widget appears wherever the snippet loads. To keep it off certain pages — checkout, a members area, your admin — either place the snippet only on the templates you want, or wrap it in a condition:

<script>
  if (!location.pathname.startsWith("/checkout")) {
    window.__ecd = { license: "YOUR-LICENSE-KEY" };
    var s = document.createElement("script");
    s.async = true;
    s.src = "https://cdn.easychatdesk.com/widget.min.js";
    document.body.appendChild(s);
  }
</script>

Verifying the install

Three things worth checking before you call it done:

1. The launcher appears on a normal page load, not just after a hard refresh.
2. A test message arrives in your dashboard inbox. Send one from an incognito window so you are treated as a visitor rather than an agent.
3. No console errors. Open developer tools and look for anything mentioning widget.min.js. A blocked request usually means a Content Security Policy needs cdn.easychatdesk.com added to script-src.

Staging and multiple sites

You can run the same license on a staging site while you test. If you run several sites, use a separate license per site so conversations, settings and reporting stay separated.

Next: customise the widget so it looks like it belongs on your site.