---
title: "Embed the widget on your website"
description: "Copy the embed snippet from the Configuration tab of a website widget channel, paste it into your pages, list the domain and send a test message."
updated: "2026-08-28"
audience: [administrator]
source: "https://helpdesk-docs.svr1.feedapp.click/en/widget/nhung-vao-website"
---

Once the channel exists, the remaining work is on your own site: two script
tags and one declared domain. This page runs from the copy button in the
console to the launcher appearing on the page.

## Goal [#goal]

The chat panel appears in the corner of your website, and anything a visitor
sends from it lands in the workspace **Conversations** queue.

## Before you begin [#before-you-begin]

* A website widget channel already exists. If not, work through [Create your first channel](/en/bat-dau/tao-kenh-dau-tien) first.
* An account that may edit a channel. An administrator always can; any other role needs a permission group that allows it.
* Somewhere to paste HTML into that site — a theme, a layout file or a tag manager.
* The console address of your workspace, in the form `https://<your-domain>`. The snippet is built from that address.

## Steps [#steps]

1. In the left column press **Channels**, then open the website widget channel you
   want to embed.
2. Open the **Configuration** tab. The **Embed Code** section shows the snippet
   with a copy button in the top-right corner of the code block.

   ![The Embed Code section of the Configuration tab: a dark code block holding two script tags, the websiteToken replaced by a placeholder, and a copy button in the top-right corner](https://helpdesk-docs.svr1.feedapp.click/images/docs/widget/nhung-vao-website/02-ma-nhung.en.webp)

   *The Embed Code block, with the website token replaced by a placeholder.*
3. Press the copy button. The console confirms with **Copied to clipboard**.
4. Paste the snippet into your website, right before the closing `</body>` tag, on
   every page that should carry the chat panel.
5. Add `baseUrl` to the `run()` call, as in the sample below. The copied snippet
   omits it, and without it the panel is loaded from `http://localhost:5174`.
6. Back in the **Configuration** tab, type your site's domain into **Target Domain
   Whitelist** and press **Add**. The domain becomes a small chip under the field.
7. Press **Save Settings**, then reload your website.

The finished snippet, with two values to replace:

```html
<script src="https://<your-domain>/widget.js"></script>
<script>
  window.CustomChatSDK.run({
    websiteToken: "<WEBSITE_TOKEN>",
    baseUrl: "https://<your-domain>"
  });
</script>
```

`<WEBSITE_TOKEN>` is the string the console already filled in for you inside the
**Embed Code** block; it names the channel and is public by design.
`<your-domain>` is the console address — one host serves both `widget.js` and
the widget document.

> **Note:** `run()` takes a few more options. `position` (`"left"` or `"right"`) overrides
> the **Widget Position** saved in the console, and `unreadTitle` changes the
> notice that flashes in the browser tab title while messages are unread. Leave
> `position` out if you want the console setting to take effect.

## Verify [#verify]

Reload your website and look for the launcher in the bottom corner. Click it,
type a test line and send it.

In the console, open **Conversations** and pick the **All** tab. The test line
must appear as a new conversation, carrying the name of the channel you embedded,
within a few seconds.

## Troubleshooting [#troubleshooting]

| Symptom                                                              | Cause                                                                                  | What to do                                              |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Nothing appears in the corner of the page                            | The `run()` call has no `baseUrl`, so the panel is loaded from `http://localhost:5174` | Add `baseUrl` pointing at the console address           |
| The browser console prints `CustomChatSDK: websiteToken is required` | The snippet lost its `websiteToken` argument                                           | Copy the whole **Embed Code** block again               |
| The launcher appears but opens an empty frame                        | The running domain is absent from **Target Domain Whitelist**                          | Add that exact domain, `www` variant included, and save |
| It works on staging but not in production                            | The two live on different domains and only one is listed                               | List both domains on the same channel                   |
| The launcher sits on the wrong side                                  | The snippet passes `position`, which outranks the channel setting                      | Remove `position` from the `run()` call                 |

## Next steps [#next-steps]

* [Customize color, position and greeting](/en/widget/tuy-bien-giao-dien)
* [Allow anonymous chat, or require a sign-in](/en/widget/chat-an-danh-hay-bat-dang-nhap)
* [Handle your first conversation](/en/bat-dau/xu-ly-hoi-thoai-dau-tien)