URL Pattern Matching
Configuring URLs for Page Inclusion and Exclusion
Squid uses full URLs, including the domain, to determine where to include or exclude VisitorID identification. This ensures precise targeting, especially if you run Squid across multiple domains or subdomains.
By default, Squid identifies visitors on all pages. These settings allow you to focus identification on the pages that matter most for your business goals.
How URL Matching Works
When adding URLs to your Page Inclusion List or Page Exclusion List, Squid matches against the full domain and path.
For example:
- Adding
https://www.yoursite.com/pricing
matches exactly that page on that domain. - Adding
https://blog.yoursite.com/*
matches all pages under your blog subdomain at the root, BUT not nested path segments likehttps://blog.yoursite.com/blog/blog123
. - Adding
https://blog.yoursite.com/**
matches all pages under your blog subdomain at the root AND nested path segments likehttps://blog.yoursite.com/blog/blog123
.
Using Wildcards
Squid supports:
*
to match a single path segment**
to match multiple nested path segments
Examples
URL | Pattern | Match? |
---|---|---|
✅ | ||
✅ | ||
✅ | ||
✅ | ||
❌ |
Wildcard Behavior
*
matches exactly one segment in the path.
For example, https://www.yoursite.com/projects/*/profiles
matches /projects/123/profiles
but not /projects/123/profiles/456
.
**
matches zero or more segments, including nested paths.
For example, https://www.yoursite.com/projects/**
matches any path under /projects/
, like https://www.yoursite.com/projects/123'
https://www.yoursite.com/projects/123/abc'
https://www.yoursite.com/projects/123/abc/890
Matching Domains
Because Squid requires the full domain in your pattern, always enter the complete URL including:
- Protocol (
https://
) - Domain (
www.yoursite.com
) - Path (
/pricing
)
For example:
✅ https://www.yoursite.com/pricing
✅ https://app.yoursite.com/dashboard/**
Best Practice Decision
- Use Inclusion when you want to identify visitors only on a few specific URLs.
- Use Exclusion when you want to identify visitors on most pages, except a few specific URLs.
⚠️ Critical Note
Inclusion List enabled with no URLs: No visitors will be identified because there is nothing to include.
Exclusion List enabled with no URLs: Identification happens on all pages as usual.
👉 Always ensure your lists contain URLs if enabled. If you are not using them, keep both settings OFF to continue identifying visitors on all pages.
🔎 Additional Note
These lists only affect visitor identification. All other tracking continues as normal.
If you need assistance crafting specific URL patterns for your website structure, chat us up via the chat bot anytime.
Updated on: 04/07/2025
Thank you!