Skip to main content

Configuring Your Tracking Site: Domain and Allowed Domains

How to edit your tracking site's name, primary domain, and allowed domains from the Intent dashboard — including how to whitelist staging or dev environments so their visits are recorded correctly.

Written by Alexander Shartsis

Each tracking site in Skyp has a primary domain and an optional list of allowed domains. The primary domain tells Skyp which host owns the site; allowed domains let you whitelist additional environments — like a staging server or localhost — so their visit data is recorded alongside your production traffic.


Editing your site settings

  1. Go to Intent in the left sidebar.

  2. Find the site card you want to update and click the menu (three-dot icon) on the card.

  3. Choose Edit settings. A dialog opens with three fields: Website name, Domain, and Allowed domains.

  4. Update the fields as needed (see descriptions below), then click Save.


Field reference

Website name

A label for this site — shown on the card and in your Visits dashboard. Use something recognisable, like your company name or the environment ("Acme Corp – Production").

Domain

Your site's primary domain (e.g. acme.com). Skyp uses this to validate incoming visit beacons — beacons from hosts that don't match the domain are flagged. Subdomains are automatically included: setting acme.com also covers www.acme.com, app.acme.com, and so on. You can include or omit https://, www., and trailing slashes — Skyp normalises them.

Allowed domains

A comma-separated list of additional hosts whose beacons Skyp should always accept, regardless of the primary domain check. Use this to whitelist environments that would otherwise be filtered:

  • Staging or preview environments — e.g. staging.acme.com, preview.acme.com

  • Local development — add localhost to let your local environment send beacons to this site

  • Custom domains — any other host that should be treated as belonging to this site

Separate entries with commas or new lines. Formatting is flexible — https://www.staging.acme.com/ and staging.acme.com are treated the same way.

Tip: Allowed domains are shown directly on the site card once set, so you can confirm what's whitelisted at a glance.


How domain filtering works

When a visit beacon arrives at Skyp, it is checked against the site's primary domain and allowed domains list:

  • If the beacon's origin matches the primary domain (including subdomains) or any allowed domain, the visit is recorded.

  • If the beacon comes from a host not on either list, the visit is still recorded in most cases but may be flagged with a domain-mismatch warning in the beacon response. This lets you spot misconfigured snippets without dropping legitimate data.

  • Beacons from localhost or private IP addresses are dropped automatically unless localhost (or the specific host) appears in your Allowed domains list.

To see which domains are currently sending beacons, check the Visits dashboard — each visit row shows the page host.


Where to find your tracking snippet

If you need the JavaScript snippet to paste into your website, go to Intent, open the menu on the site card, and choose Copy snippet. Install it once on every page you want to track (typically in a shared layout or <head> tag).

Did this answer your question?