Skip to main content

Start Chat Buttons: URL Guidelines for Page Visibility Rules

This article explains how to write URL rules for Page Visibility Control so your chat widget appears exactly where you want it.

Updated over 3 weeks ago

Page Visibility is a premium feature.

What this feature does

Page Visibility Control lets you decide which pages should show (or hide) the widget based on URL patterns.

  • Whitelist mode: show the widget only on matching pages.

  • Blacklist mode: show the widget on all pages except matching pages.

Before you begin

  1. Turn on Page Visibility in your app settings.

  2. Choose a mode (Whitelist or Blacklist).

  3. Enter one or more rules in the rule input.

  4. Publish/Save your changes.

URL rule format

Rules are entered as a comma-separated list.

  • Separate rules with commas.

  • Spaces are allowed (they are trimmed automatically).

  • Use * as a wildcard.

  • Use page paths/slugs, not full domains.

Good examples

  • /

  • /home

  • /about

  • /blog/*

  • *product*

  • /checkout, /thank-you, /admin/*

Avoid

How matching works

1) Exact match

Use a full path to target one page:

  • /home

  • /about

2) Wildcard match (*)

Use * to match variable parts of a URL:

  • /blog/* matches /blog/post-1, /blog/2026/launch, etc.

  • *product* matches any URL that contains product.

Mode behavior

Whitelist

Only URLs that match your rules will show the widget.

Example:

  • Rules: /, /pricing, /blog/*

  • Result: widget appears only on home, pricing, and blog pages.

Blacklist

All URLs show the widget except URLs that match your rules.

Example:

  • Rules: /checkout, /thank-you, /admin/*

  • Result: widget is hidden on checkout, thank-you, and admin pages.

Quick presets available in the UI

  • Homepage Only -> /home, /

  • Blog Only -> /blog/*, /posts/*

  • Exclude Admin -> /admin/*, /dashboard/*

  • Clear All -> removes all rules

Important behavior to know

  • Enabling Page Visibility starts with an empty whitelist and empty rules.

  • Switching between Whitelist and Blacklist clears existing rules.

  • Disabling Page Visibility clears rules and returns to default behavior (show on all pages).

Troubleshooting

The widget disappeared from all pages

Most likely: Page Visibility is enabled in Whitelist mode with no rules.

Fix: Add at least one rule (for example /) or disable Page Visibility.

A rule is not working

Check the following:

  • You entered a slug/path (like /about) instead of a full URL.

  • Your wildcard is placed correctly (/blog/*, not blog* if you need path matching).

  • Rules are separated by commas.

  • Changes were published after editing.

The rule is too broad

If you used *product*, it may match more pages than expected. Use a more specific path rule such as /products/*.

Best practices

  • Start with a small set of rules and test page by page.

  • Prefer specific patterns over broad wildcards.

  • Keep related rules grouped and easy to read.

  • Re-check rules whenever you switch visibility mode (because mode changes reset rules).

Did this answer your question?