Docs/Marqs & URL Matching

Marqs & URL Matching

Learn how URL-based Marqs work — exact matches, regex patterns, and best practices for targeting any page.

What is a Marq?

A Marq connects your existing guides to the exact web page where your team needs them. Each Marq has a URL pattern and one or more guide links. When someone visits a matching page, WingMarq automatically surfaces the attached guides.

Host matching

The simplest match type. Enter a domain like app.powerbi.com and WingMarq will show your guides on every page of that site.

You can also paste a full URL — WingMarq will automatically extract the hostname. For example, pasting https://app.powerbi.com/groups/abc/reports/xyz will match all pages on app.powerbi.com.

Host matching also covers subdomains — so powerbi.com would match both app.powerbi.com and msit.powerbi.com.

Regex matching

For more precise targeting, use a regex pattern. This is tested against the full page URL, so you can match specific reports, dashboards, or pages.

Examples

https://app\.powerbi\.com/reports/.*— all Power BI reports

https://.*\.sharepoint\.com/sites/HR/.*— any SharePoint HR site

https://timesheet\.company\.com/submit— one specific page

Regex patterns use standard JavaScript regex syntax. You can enable regex mode in the Advanced Options section when creating or editing a Marq.

Best practices

  • Start with host matching — it covers the most common case and is easiest to set up.
  • Use regex for precision — when you need guides on a specific report or page, not the whole site.
  • One Marq per context — group related guides together. If a Power BI report has 3 how-to guides, put them all in one Marq rather than creating 3 separate ones.
  • Test your patterns — after creating a Marq, visit the target page with the extension installed to verify guides appear correctly.