For AI agents: a documentation index is available at /llms.txt
Skip to main content

Domain filtering

Manage persistent domain exclusions. Exclude sensitive domains locally before upload. Browserless never sees filtered data.

Command: browserless profile exclude <subcommand>

Subcommands​

  • add <domain> Add a domain to the persistent exclusion list.
  • list Print all persistently excluded domains.
  • rm <domain> Remove a domain from the persistent exclusion list.

Suffix-match rules: example.com matches example.com, .example.com, www.example.com, and sub.www.example.com.

Examples​

Add a domain exclusion

browserless profile exclude add chase.com

List exclusions

browserless profile exclude list

Remove an exclusion

browserless profile exclude rm chase.com
info

The CLI always filters localhost, *.local, *.internal, and IP-literal hosts regardless of your exclusion list. These protect against accidentally uploading intranet or local-network state that would never apply to a cloud session.

Per-run filtering​

In addition to the persistent exclusion list, you can filter domains at capture time:

  • --exclude-domain <domain> — append a domain for this run only (repeatable).
  • --no-default-excludes — skip the persistent exclusion list for this run.
  • --only-domain <domain> — allowlist mode: capture only domains matching this pattern (repeatable, applies after --exclude-domain).

See Profile commands for the full flags reference.