> ## Documentation Index > Fetch the complete documentation index at: https://docs.getchatads.com/llms.txt > Use this file to discover all available pages before exploring further. # Installation > Install the ChatAds widget on any platform in minutes 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](https://app.getchatads.com), 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](https://app.getchatads.com) 2. Open the **Settings** 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 `` tag: ```html theme={null} ``` The script also works with the `defer` or `async` attribute if you prefer to load it from the ``. See [Performance](/guides/performance) for load-behavior details. The easiest route is the official [ChatAds plugin](https://wordpress.org/plugins/chatads/) - you paste your widget key instead of the snippet, and there's nothing to keep in sync when new widget features ship. **Option A: Official ChatAds plugin (recommended)** 1. In your WordPress admin, go to **Plugins > Add New**, search for **ChatAds**, and install it 2. Activate the plugin 3. Go to **Settings > ChatAds**, paste your widget key (starts with `cwk_`), and save **Option B: Code-insertion plugin** 1. Install a header/footer script plugin, e.g. [WPCode](https://wordpress.org/plugins/insert-headers-and-footers/) 2. Go to the plugin's header/footer settings screen 3. Paste the snippet into the **Footer** field and save **Option C: Google Tag Manager** If GTM is already installed on the site, use the **Google Tag Manager** tab in this guide instead - no plugin needed. Pasting the snippet directly into `footer.php` via Appearance > Theme File Editor also works, but theme updates or switching themes can wipe it out. The plugin or GTM route survives theme changes. 1. In your site admin, go to **Settings > Advanced > Code Injection** 2. Paste the snippet into the **Footer** field 3. Save Code injection requires a Squarespace Business plan or higher. 1. Open **Site Settings > Custom Code** 2. Paste the snippet into the **Footer Code** field 3. Save and publish Custom code requires a paid Webflow site plan. 1. Go to **Settings > Custom Code** in your site dashboard 2. Click **Add Custom Code**, paste the snippet 3. Set it to load on **All pages**, placed in **Body - end** 4. Apply Custom code requires a Wix premium plan with a connected domain. 1. Go to **Settings > Code injection** 2. Paste the snippet into **Site footer** 3. Save 1. Create a new **Custom HTML** tag 2. Paste the snippet as the tag's HTML 3. Set the trigger to **All Pages** 4. Publish the container If you only want the widget on articles, use ChatAds [page rules](/guides/widget-configuration#page-rules) rather than GTM triggers - rules update instantly without republishing your container. ## 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?](/guides/widget-messages#why-isnt-the-widget-showing-at-all) walks through every case. ## Step 4: Lock It Down Before going live, add your production domain(s) to **Allowed Domains** on the Settings tab. With an empty allowlist, any site can embed your widget key and consume your daily message allowance. See [Widget Configuration](/guides/widget-configuration) for domains, page rules, and visitor limits. ## Managing Your Widget Key You can reset your key from the Settings 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 Allowed domains, page rules, mobile and language controls, visitor limits. Colors, welcome message, starter questions, and the AI's behavior. Amazon affiliate links, on-page link scraping, or both. Daily message caps, burst protection, and message screening.