> ## 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.

# Widget Configuration

> Control where the widget appears and who can use it

All access controls live on the **Set-Up** tab of the [dashboard](https://app.getchatads.com). Changes apply server-side, so you never need to redeploy your embed snippet.

## Master Settings

<Frame caption="Master Settings on the Set-Up tab">
  <img src="https://mintcdn.com/chatads/I2Wk2rHIxsmVqnyY/images/widget/setup-master-settings.png?fit=max&auto=format&n=I2Wk2rHIxsmVqnyY&q=85&s=9e05fc42d9427d2195c055ebf738387b" alt="Master Settings card with widget enabled, English browsers only, show on mobile, and max messages per day settings" width="1104" height="395" data-path="images/widget/setup-master-settings.png" />
</Frame>

* **Widget enabled** - the master switch. Turn it off and the widget disappears from your site immediately.
* **English browsers only** - hides the widget when the visitor's browser language is not English. Chat is English-only and sponsored Amazon links are US/UK only, so this is on by default; the dashboard shows a warning if you turn it off.
* **Show on mobile** - on by default. The widget works well on small screens; toggle off for a desktop-only experience.
* **Max messages per day per user** - see [Per-Visitor Daily Limits](#per-visitor-daily-limits) below.

## Allowed Domains

Restrict which domains can embed your widget. Leave the list empty to allow any site, or add one or more domains to prevent unauthorized use. Domain checks happen on widget impression, chat, and click events. Subdomains must be listed explicitly; `www.` is matched automatically.

<Frame caption="Allowed Domains on the Set-Up tab">
  <img src="https://mintcdn.com/chatads/I2Wk2rHIxsmVqnyY/images/widget/setup-allowed-domains.png?fit=max&auto=format&n=I2Wk2rHIxsmVqnyY&q=85&s=102bdc261d64cde23d0fd773c2333d08" alt="Allowed Domains card with two domains added as chips" width="1104" height="222" data-path="images/widget/setup-allowed-domains.png" />
</Frame>

<Warning>
  Always add at least one allowed domain before going to production. With an empty allowlist, anybody could embed your widget key on their site and consume your daily message allowance.
</Warning>

## Page Rules

Control which pages the widget appears on 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

<Frame caption="Include and exclude path rules">
  <img src="https://mintcdn.com/chatads/I2Wk2rHIxsmVqnyY/images/widget/setup-page-rules.png?fit=max&auto=format&n=I2Wk2rHIxsmVqnyY&q=85&s=c19a73bbcb0da3f973cc006e727cc1c9" alt="Page Rules card with include paths and exclude paths inputs" width="1104" height="340" data-path="images/widget/setup-page-rules.png" />
</Frame>

For example, `Include: /blog/*` with `Exclude: /blog/admin/*` shows the widget on blog pages except admin pages.

## Per-Visitor Daily Limits

Each visitor can send up to 20 messages per day by default (tracked by IP, reset daily). When a visitor uses up their allowance, the input is disabled with the notice "You've used your N messages for today - come back tomorrow!"

Use this to keep individual heavy users from consuming your team's [daily message limit](/guides/rate-limits).

<Note>
  Raising the per-visitor limit above the default of 20 requires domain verification: (1) add a public domain to Allowed Domains and (2) load the widget once on that domain so our system detects it. Localhost domains can be added for local testing but don't count toward verification. Lowering the limit works immediately.
</Note>