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 this week

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

  • https://example.com/about (full domain is not needed)

  • Regex syntax (rules are simple URL patterns, not regular expressions)

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?