Installation

Add the Yaplet widget to any website with a single code snippet, or follow a platform-specific guide for WooCommerce, Shopify, WordPress, and popular JavaScript frameworks.

Embed Code

Adding the widget to your site takes a single script tag. Paste it just above the closing </body> tag on every page where you want the widget to appear.

Find your embed code

In your Yaplet dashboard, go to Brand → Chat widget and open the Install tab, headed Put Yaplet on your website. The tab asks Where does your website run? If Yaplet recognized your platform when your brand was set up (WordPress, Shopify, Wix, Squarespace, Webflow, UNAS or Shoprenter), that button is already selected, with the line We think your site runs on followed by the platform's name. Anything it did not recognize starts on Other website. You can always pick another platform, and a platform you click yourself is remembered in this browser. The tab shows the code in the form the selected platform needs. The snippet shown there already has your widget's ID filled in, and the copy button puts it on your clipboard.

Above the steps, a light tells you where the install stands: a gray Waiting for your website… that turns green, Live on and your site's address, as soon as the chat first loads on your website.

Add it to your site

Insert the snippet into your website's HTML, just above the closing </body> tag:

HTML
<script>
    !(function (Yaplet, t, i) {
        if (!(Yaplet = window.Yaplet = window.Yaplet || []).invoked) {
            var widgetId = "YOUR_WIDGET_ID";
            for (
                window.YapletActions = [],
                    Yaplet.invoked = !0,
                    Yaplet.methods = [
                        "identify",
                        "setEnvironment",
                        "setTags",
                        "attachCustomData",
                        "setCustomData",
                        "removeCustomData",
                        "clearCustomData",
                        "registerCustomAction",
                        "trackEvent",
                        "log",
                        "showSurvey",
                        "sendSilentCrashReport",
                        "startFeedbackFlow",
                        "startBot",
                        "setAppBuildNumber",
                        "setAppVersionCode",
                        "setApiUrl",
                        "setFrameUrl",
                        "isOpened",
                        "open",
                        "close",
                        "on",
                        "setLanguage",
                        "setOfflineMode",
                        "initialize",
                        "disableConsoleLogOverwrite",
                        "logEvent",
                        "hide",
                        "enableShortcuts",
                        "showFeedbackButton",
                        "destroy",
                        "getIdentity",
                        "isUserIdentified",
                        "clearIdentity",
                        "openConversation",
                        "openHelpCenterCollection",
                        "openHelpCenterArticle",
                        "openNewsArticle",
                        "isLiveMode",
                        "setFlowConfig",
                        "setAdminUrl",
                        "setWSApiUrl",
                    ],
                    Yaplet.f = function (e) {
                        return function () {
                            var t = Array.prototype.slice.call(arguments);
                            window.YapletActions.push({ e: e, a: t });
                        };
                    },
                    t = 0;
                t < Yaplet.methods.length;
                t++
            )
                Yaplet[(i = Yaplet.methods[t])] = Yaplet.f(i);
            ((Yaplet.load = function (id) {
                var t = document.getElementsByTagName("head")[0],
                    i = document.createElement("script");
                ((i.type = "text/javascript"), (i.async = !0), (i.src = "https://yaplet.com/api/sdk/loader?widgetId=" + encodeURIComponent(id)), t.appendChild(i));
            }),
                Yaplet.load(widgetId),
                Yaplet.initialize(widgetId));
        }
    })();
</script>
When you paste the code into an HTML page, it must start with a <script> line and end with a </script> line; if what you copied starts with !function (Yaplet instead, type <script> on a new line before it and </script> on a new line after it. If you are copying the snippet from this page instead, replace YOUR_WIDGET_ID with the ID shown on the Install tab.

Verify it works

Reload your website. You should see the Yaplet launcher button in the bottom-right corner, and the light on the Install tab turns green. Click the button to open the widget and confirm everything loads correctly.

Signing your users in? Calls to Yaplet.identify() are rejected unless they carry a hash of the user's ID, signed on your server. The secret for that is on the same Install tab, under Identity verification. Set it up before you ship identify(), or your signed-in users will stay anonymous in the inbox.

If Someone Else Runs Your Website

Under the code, My developer does this opens a box with three ways to pass the install on:

  • Copy link — a link to a page made for your developer. They need no Yaplet login. It shows the steps for your platform, the code with a copy button and the same light as your Install tab, plus a Different platform? row in case the platform is wrong. The page is in Hungarian when your dashboard is on yaplet.hu.
  • Copy message — a ready-made message to paste into any chat app or email: your website, the platform, the steps, the link, the code and the guide.
  • Email — opens your own mail app with the same message, ready for you to add your developer's address.

The light on your Install tab turns green once the chat is live on your website, so you see it without asking.

Can't get to your site's code right now? Your chat link, at the bottom of the tab, is a page where visitors chat with you with nothing installed. Share it on your contact page, Instagram bio or Google profile, and use Copy to put it on your clipboard. Every workspace gets it, free ones too, and the page shows your brand's logo on a band in your brand color.

Framework-Specific Installation

If you're using a JavaScript framework, add the same script tag to your app shell or layout component:

Paste the embed code directly into your HTML file before </body>.

Platform Guides

For specific platforms, follow the dedicated step-by-step guides:

WordPress

Install the official Yaplet – Live Chat & AI Chatbot plugin and enter your widget ID — no code to paste.

WooCommerce

Use the same Yaplet – Live Chat & AI Chatbot plugin on your store, or paste the code with WPCode.

Shopify

Paste the code into your theme's layout file.

Webflow

Add the code in Site settings → Custom code (paid plans).

UNAS

Add the code through UNAS's built-in script insertion menu.

Shoprenter

Add the code on the theme's custom scripts tab.

Wix

Add the code with Wix's Custom Code setting (Premium sites).

Squarespace

Add the code with Code Injection (Core plan or higher).

Google Tag Manager

Add the code as a Custom HTML tag on any site that runs Tag Manager.

More platforms

BigCommerce, Framer, Ghost, Shoptet, Webnode and more, plus the builders that can't run the widget.

Don't see your platform? The embed code above works on any website that lets you add code to every page. If your site runs Google Tag Manager, use the Tag Manager guide.

© 2026 Yaplet. All rights reserved.