Whitelisting Domains for Your Marketing Agent Widget

Last updated: August 10, 2026

For security, Marketing Agent widgets should run only on approved domains. Before your agent appears on a website, add the intended domain to the agent's whitelist.

Prerequisites

  • Access to app.docketai.com

  • At least one agent created

  • The domains where you want the widget to appear

Accessing Whitelist Domains

  1. Log in to app.docketai.com.

  2. Click Marketing Agent Configuration in the left sidebar.

  3. Select the agent you want to configure.

  4. Click the Widget tab.

  5. Scroll to the Whitelist Domains section.

Use this section to add, review, and remove approved website domains.

Adding a Domain

  1. In the Whitelist Domains section, add the domain where the widget should run.

  2. Save or add the domain using the control shown in the app.

  3. Confirm the domain appears in the whitelist.

After adding the domain, test the widget on that domain before considering deployment complete.

Domain format

  • Use the exact domain where the widget will run.

  • Include subdomains if needed. For example, www.example.com and example.com may need to be reviewed separately.

  • Add each production, staging, or campaign domain that should run the widget.

Managing Whitelisted Domains

After adding domains, review the whitelist before deploying the widget script.

Removing a domain

Remove domains that should no longer run the widget, then test the affected site.

How Whitelisting Affects Other Features

Feature

Impact

Widget Behavior

Page targeting rules (All Pages, Selected Pages, On Click) are configured per whitelisted domain.

Deploy script

The website still needs the deploy script installed after the domain is approved.

Standalone Page

Not affected. The standalone page is hosted by Docket and does not require domain whitelisting.

Preview

Not affected. The Preview button in the agent configuration works regardless of whitelisted domains.

Per-Agent Whitelisting

Treat domain approval as part of each agent's deployment checklist. This means:

  • Different agents can be deployed to different domains.

  • Different campaign or product sites can use different agents.

  • Multiple agents can be whitelisted for the same domain, but only one agent's widget should be deployed per page to avoid conflicts.

Common Scenarios

Scenario

Domains to Add

Main website only

Your primary website domain

Main site + blog

Main domain and blog subdomain

Staging + production

Staging domain and production domain

Multiple product sites

Each product-site domain

Campaign page

The campaign or landing-page domain

Verify Domain Access

  1. Reload the Widget tab and confirm the exact domain remains listed under Whitelist Domains.

  2. Open a page on that domain where the Docket script is installed.

  3. Confirm the widget follows the saved Widget Behaviour rule for that page.

  4. Open a page on a domain that is not listed and confirm that deployment is not treated as approved for this agent.

The domain setup is ready when the saved entry persists and the widget loads only on the intended approved domain and pages.

Troubleshooting

Issue

Solution

Widget not appearing on my site

Verify the exact domain, agent status, widget behavior, and deploy script.

Widget appears on staging but not production

Ensure the production domain is whitelisted separately from the staging domain.

Removed a domain but widget still shows

Recheck the active domain, browser cache, and installed script.

Related Articles