Skip to main content
ChatAds installs with a single script tag. You add it once, and everything else - appearance, monetization, page rules - is managed server-side from the dashboard, so you never have to touch your site’s code again.

​
Step 1: Get Your Widget Key

ChatAds authenticates your widget with a key that starts with cwk_. New accounts already have one waiting for you, so you just need to copy it.
  1. Log into app.getchatads.com
  2. Open the Set-Up tab
  3. Copy your widget key and embed snippet
Embed Snippet card in the ChatAds dashboard with a copyable script tag

​
Step 2: Add the Snippet to Your Site

Paste the snippet into your site’s HTML, ideally just before the closing </body> tag:
<script async src="https://www.getchatads.com/widget.js?key=cwk_your_widget_key"></script>
The script also works with the defer or async attribute if you prefer to load it from the <head>. See Performance for load-behavior details.

​
Step 3: Verify It’s Working

  1. Open any page on your site. The launcher pill (default label “Ask AI”) appears in the bottom corner within a moment of the page finishing loading.
  2. Open the widget and send a test question.
  3. Check the Usage tab in the dashboard - your message and click appear immediately; page loads are batched, so give them a minute or two to show up in the daily counts.
If the launcher doesn’t appear, the widget is deliberately hiding itself: the most common causes are an Allowed Domains list that doesn’t include the site, page rules that exclude the current path, or the English-browsers-only setting. Why isn’t the widget showing? walks through every case.

​
Step 4: Lock It Down

Before going live, add your production domain(s) to Allowed Domains on the Set-Up tab. With an empty allowlist, any site can embed your widget key and consume your daily message allowance. See Widget Configuration for domains, page rules, and visitor limits.

​
Managing Your Widget Key

You can reset your key from the Set-Up tab if it is ever misused. Regenerating the key invalidates your current embed snippet immediately - your widget stops working until you deploy the new snippet, so update your site right away.
Widget keys are visible in your page source by design (like any client-side analytics or chat tag). The key only works on domains in your allowlist, is limited to widget chat, and cannot read your account data or settings.

​
Next Steps

Configure access

Allowed domains, page rules, mobile and language controls, visitor limits.

Customize the widget

Colors, welcome message, starter questions, and the AI’s behavior.

Turn on monetization

Amazon affiliate links, on-page link scraping, or both.

Understand your limits

Daily message caps, burst protection, and message screening.