Skip to main content

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.

​
Overview

ChatAside is an embeddable AI chat widget for blogs and content sites. You install it with a single script tag, authenticate it with a widget key, and manage behavior server-side from the dashboard.

​
Embed Snippet

Add this script tag to your site: 
<script src="https://chataside.com/widget.js" data-key="cwk_your_widget_key"></script>

​
Widget Keys

ChatAside uses widget keys that start with cwk_. 
cwk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Getting Your Widget Key

  1. Log into app.getchatads.com
  2. Switch to the ChatAside product
  3. Open Set-Up
  4. Generate your widget key
  5. Copy the embed snippet and add it to your site
You are able to reset your key, which you may do if it gets compromised. If you regenerate the key, your current embed snippet stops working until you deploy the new one.

​
Widget Rate Limits

Each plan has a daily widget chat cap enforced server-side.
TierDaily Team Chat Limit
Free100/day
Pro500/day
Business1500/day
When the team hits its daily limit, users that have already chatted with the widget will see, “You have hit your daily message limit” when they open it again. Anyone who hasn’t chatted yet won’t see the widget at all - it will be hidden from them.

​
Per-Minute Protection

ChatAside also uses a short-window rate limiter to protect the service from bursts and spam.
  • Team-level per-minute limit: 300 requests per minute
  • Endpoint-specific IP rate limits are also applied to widget routes
If a burst limit is exceeded, users will see an alert that the LLM is having issues.

​
Allowed Domains

You can restrict which domains are allowed to embed your widget.
  • Leave the list empty to allow the widget on any site
  • Add one or more domains such as example.com to prevent unauthorized use
  • Domain checks happen on widget impression, chat, and click events
If you are using ChatAside in production, add at least one allowed domain. Otherwise, anybody could add your assistant to their site!

​
Page Rules

You can control where the widget appears with include and exclude path rules.
  • Paths without * are exact matches
  • /blog/* matches /blog and all subpages
  • *pricing* matches any pathname containing pricing
  • Exclude rules are evaluated after include rules
Examples: 
Include: /blog/*
Exclude: /blog/admin/*
This shows the widget on blog pages except admin pages.

​
Mobile and Language Controls

ChatAside can be configured to stay hidden in a few cases:
  • hide_on_mobile: hides the widget on smaller screens. While the widget works well on mobile, it also takes up the whole real estate when opened. We recommend starting with mobile turned off, and testing it after you’re happy with desktop.
  • english_only: hides the widget when the browser language is not English. ChatAside is heavily focused on English - and the affiliate links are 100% US links - so you may want to keep it for EN browseres only.
  • Path rules: hide the widget when the current page does not match your rules

​
User Daily limits

You can set maximum messages per day by user. This uses IP and resets every day. If they exceed that number, they will see a message that says, “You’ve hit your daily message limit.” Use this to avoid abuse and keep your overall usage within your daily limits.

​
Customization

You can manage core widget behavior from the dashboard without changing your embed code.

​
Appearance

Available settings include:
  • Theme / accent color - this is the color of various accents within the opened widget
  • Bubble text - this is the default pill that appears before they open the assistant
  • Bubble color
  • Welcome message, which appears in middle of the widget when they first open it. You can add up to 200 characters
  • ChatAside branding visibility. Free plans show ChatAside branding. Paid widget tiers can hide it
  • Seeding questions — up to 3 short starter prompts shown as pill buttons in the empty chat panel. When a visitor clicks one, it pre-fills the input and sends the message immediately. Useful for surfacing common questions before the visitor types anything. Seeding questions are hidden on mobile. Each question is limited to 50 characters

​
AI Behavior

You can also configure:
  • Page context on or off
  • Custom system prompt
When page context is enabled, the widget sends content from the current page so the assistant can answer questions about that article or post. Different plans have different max word counts that are sent.

​
Custom prompt

You can add up to 500 characters of a custom prompt. This gets sent to the AI on every message. While we already have a robust, tailored prompt that we send, you can use this if there’s anything specific you want it to know.

​
Page Context

Page context makes ChatAside article-aware. The widget extracts content from the page and sends it with each message, including:
  • Headings
  • Paragraphs
  • List items
  • Table cells
  • Amazon affiliate links already present on the page
Navigation, footer, script, and widget UI content are excluded.
If you turn page context off, ChatAside behaves more like a standard site chatbot and relies less on the current page.

​
Best Practices

Restrict domains

Add your production domains so other sites cannot reuse your widget key.

Use page rules

Limit the widget to article or product pages where it is most useful.

Customize server-side

Change theme color, text, and behavior in the dashboard without editing your embed snippet.

Rotate carefully

If you regenerate your widget key, update your site immediately to avoid downtime.